新建工程

您可以在DomeOS上关联您的代码源(目前支持Gitlab)，并通过简单的配置创建一个工程，也可以不使用代码仓库中的代码源创建工程。工程将被构建成可交付的镜像文件。 点击项目名称进入工程列表页，可以看到"新建工程"，点击进入新建工程页面。

关联Gitlab代码仓库生成项目

DomeOS支持关联私有Gitlab，您可以在新建项目第一步选择Gitlab仓库，并点击"关联新账户"。输入Gitlab用户名和密码后您会看到自己的Gitlab账户已经同步到DomeOS。您可以选择一个代码项目作为此工程的代码源。

此外，还可以对工程进行如下设置：

runners-token：CI/CD pipeline的runners token，该项配置时采用该token clone代码，否则使用用户token clone代码

自动构建：工程只有被构建成镜像文件才能交付和部署。针对代码项目快速迭代的特点，DomeOS开发了智能化的持续集成功能。在关联代码仓库后，您可以在"自动构建"处指定代码项目的分支或tag，当您的代码源发生push操作，所选分支更新或出现新tag时，会自动触发一次构建，生成新的项目镜像，保证您的项目镜像和代码源同步。

工程构建类型: 工程需要构建成Docker镜像，才能被部署到运行环境中。工程构建过程包含了代码编译、docker build等操作。通用配置是DomeOS为docker初学者准备的简易Dockerfile生成功能，配置关键信息后，后台自动生成对应的Dockerfile。定制化配置是指用户通过镜像定制工具，根据Dockerfile配置文件。Java专属配置是专门为Java项目打造的，对编译和运行环境进行了分离，使镜像更加精简。还可以使用代码项目内的Dockerfile，无需自行配置构建参数生成Dockerfile。

工程名称：必填项，指定该工程名称。

点击下一步，将对新创建的工程进行进一步的配置。以下分四种情况详细介绍相关配置：

1.通用配置

如果选择通用配置，将在本步骤通过几项简单的配置生成一个Dockerfile，用于构建您的工程。可以选择手动配置，也可以点击"复制已有工程"来复制另一个工程的配置信息。主要配置参数说明：

基础镜像：用于构建的基础镜像，默认将给出镜像管理中配置的基础镜像列表用于备选。

安装依赖命令：用于安装编译依赖项的命令。

代码存放路径：镜像内存放代码的路径，代码仓库中的代码将被下载到此路径。(注意要求为绝对路径)

编译命令：执行代码编译的命令。(多条命令使用&&连接)

工作目录：代码工作路径。(注意要求的为绝对路径，默认为根目录)

启动命令：代码启动命令。(多条命令使用&&连接)

user in docker： 指定容器中用户。

编译过程环境变量：编译过程中的环境变量，将被写入Dockerfile，构建、运行过程中都会生效。

配置文件模板：若需使用dockerize配合配置模板生成配置文件，这里需要配置模板文件在代码项目中的路径以及生成配置文件的目标路径，可配置多对。

运行过程环境变量：在项目中声明并给出默认值和描述，用于提示部署运维人员在部署和升级等操作时配置。注意：此处的环境变量与构建过程无关。

配置完成后，可以点击"预览Dockerfile"查看根据配置生成的Dockerfile的内容。

点击"完成创建"即可完成工程的创建。

2. 定制配置

选择定制配置可以选择手动配置，也可以点击"复制已有工程"来复制另一个工程的配置信息。选择后将进行以下配置：

编辑Dockerfile:在此处填写Dockerfile，编写Dockerfile需要注意的是ADD指令只能通过URL获取文件；COPY指令无效。也可直接选择基础镜像进行配置。

添加配置文件：可以指定文件名和在基础镜像中的存放路径，点击编辑添加文件内容；

配置完成后，可以点击"预览Dockerfile"查看根据配置生成的Dockerfile的内容。

点击"完成创建"即可完成工程的创建。

3.Java专属配置

Java专属配置需要填写编译信息和运行信息，可以选择手动配置，也可以点击"复制已有工程"来复制另一个工程的配置信息。

编译镜像：DomeOS官方仓库中提供了部分maven和jdk镜像可以用于Java项目构建，也可以选择私有仓库中镜像用于构建。使用时，还需指定编译镜像内代码存放路径、编译结果在编译镜像中的存放路径、编译脚本、编译过程的环境变量。

运行镜像：DomeOS官方仓库中提供了部分tomcat和jre镜像可用于运行Java项目，也可以选择私有仓库中镜像用作为运行镜像。使用时还需指定编译结果在运行镜像中的存放路径、运行镜像的启动命令、运行镜像需要配置的环境变量。

工作目录：代码工作路径。(注意要求的为绝对路径，默认为根目录)

user in docker： 指定容器中用户。

配置文件模板：若需使用dockerize配合配置模板生成配置文件，这里需要配置模板文件在代码项目中的路径以及生成配置文件的目标路径，可配置多对。

点击"预览Dockerfile"可以查看用于生成运行镜像的Dockerfile。

点击"完成创建"即可完成工程的创建。

DomeOS官方仓库所提供的编译与运行镜像列表

4.使用代码项目内的Dockerfile

这种情况下无需在DomeOS中配置构建参数生成Dockerfile，仅需配置以下几项参数即可。可以选择手动配置，也可以点击"复制已有工程"来复制另一个工程的配置信息：

构建目录：代码项目内执行docker build命令的路径参数。

Dockerfile路径：镜像内的Dockerfile存放路径。需要具体到Dockerfile文件名，Dockerfile文件可随意命名。推荐在构建目录下存放Dockerfile。

运行过程环境变量：在工程中声明并给出默认值和描述，用于提示部署运维人员在部署和升级等操作时配置。注意：此处的环境变量与构建过程无关。

点击"预览Dockerfile"可以查看用于生成镜像的Dockerfile，可以选择Dockerfile所在分支或tag。

点击"完成创建"即可完成工程的创建。

不使用代码仓库生成工程

在新建工程第一步选择不使用代码仓库，可不通过代码仓库生成工程。创建过程中需使用"通用配置"或者"定制化配置"生成Dockerfile，用于构建工程。