photoprism/development

PhotoPrism开发环境镜像

镜像概述和主要用途

该镜像为PhotoPrism应用程序提供容器化开发环境，用于构建、测试和调试PhotoPrism。通过Docker容器化方式，集成了开发所需的全部依赖和工具，避免手动配置环境的复杂性，确保开发环境的一致性和可靠性。

核心功能和特性

• 依赖集成：包含Go（≥1.17）、TensorFlow for C、Make、NPM、MySQL等开发必要工具和库
• 便捷部署：提供docker-compose配置，快速启动开发环境
• 开发支持：支持运行测试命令（如make test）、构建应用（如make all）及启动内置Web服务器
• 环境一致性：通过容器化确保不同开发环境的一致性，避免因环境差异导致的问题

使用场景和适用范围

适用于PhotoPrism开发人员进行应用功能开发、代码测试、调试及构建。不适用于生产环境，仅作为测试和开发用途。

使用方法和配置说明

前置要求

在使用前，确保系统已安装：

• https://git-scm.com/downloads
• https://store.docker.com/search?q=docker&type=edition&offering=community

注意：不推荐基于Dockerfile手动创建开发环境，可能导致测试结果可靠性降低，且无法使用其他Dockerfile（如TensorFlow相关配置）。

部署步骤

步骤1：克隆项目

使用Git克隆PhotoPrism项目代码：

bash
git clone git@github.com:photoprism/photoprism.git

步骤2：启动Docker容器

进入项目目录并启动容器：

bash
cd photoprism
docker-compose up

注意：此docker-compose配置仅用于测试和开发目的。

步骤3：进入容器终端

打开Photoprism容器终端：

bash
docker-compose exec photoprism bash

常用命令

在容器终端内，可运行以下命令：

• 构建并测试应用：

  bash
  make all
  

• 运行测试：

  bash
  make test
  

• 启动内置Web服务器：

  bash
  ./photoprism start
  

配置说明

• Web服务器：默认监听地址为http://localhost:2342/，配置可在https://github.com/photoprism/photoprism/blob/develop/docker-compose.yml中查看
• Make目标：所有make命令目标可在https://github.com/photoprism/photoprism/blob/develop/Makefile中查看，例如`make install`会构建无调试信息的生产二进制文件并安装到用户目录（包含所有资源）

参考文档

更多详情请查阅https://github.com/photoprism/photoprism/wiki