设置开发环境

重要

开发环境不再处于积极开发阶段。

虽然当前功能仍然可用,但我们可能需要更长的时间才能回复支持请求。

Docker Desktop 4.13 中开发环境的更改

Docker 简化了配置开发环境项目的方式。您只需一个 compose-dev.yaml 文件即可开始使用。如果您有一个带有 .docker/ 文件夹的现有项目,则下次启动时会自动迁移该项目。

如果您使用的是 .docker/docker-compose.yaml,我们会将其移至 ../compose-dev.yaml。如果您使用的是 .docker/config.json,我们会创建一个 ../compose-dev.yaml 文件,其中包含一个名为“app”的单个服务。它被配置为使用 JSON 中引用的镜像或 Dockerfile 作为起点。

要设置开发环境,需要执行其他配置步骤,以告诉 Docker Desktop 如何构建、启动和使用适合您服务的镜像。

开发环境使用位于项目根目录的 compose-dev.yaml 文件。此文件允许您定义专用服务所需的镜像、要公开的端口以及其他配置选项。

以下是一个示例 compose-dev.yaml 文件。

version: "3.7"
services:
  backend:
    build:
      context: backend
      target: development
    secrets:
      - db-password
    depends_on:
      - db
  db:
    image: mariadb
    restart: always
    healthcheck:
      test: [ "CMD", "mysqladmin", "ping", "-h", "127.0.0.1", "--silent" ]
      interval: 3s
      retries: 5
      start_period: 30s
    secrets:
      - db-password
    volumes:
      - db-data:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=example
      - MYSQL_ROOT_PASSWORD_FILE=/run/secrets/db-password
    expose:
      - 3306
  proxy:
    build: proxy
    ports:
      - 8080:80
    depends_on:
      - backend
volumes:
  db-data:
secrets:
  db-password:
    file: db/password.txt

在 yaml 文件中,构建上下文 backend 指定容器应使用位于 backend 目录(context 属性)的 Dockerfile 中的 development 阶段(target 属性)进行构建。

Dockerfile 的 development 阶段定义如下

# syntax=docker/dockerfile:1
FROM golang:1.16-alpine AS build
WORKDIR /go/src/github.com/org/repo
COPY . .
RUN go build -o server .
FROM build AS development
RUN apk update \
    && apk add git
CMD ["go", "run", "main.go"]
FROM alpine:3.12
EXPOSE 8000
COPY --from=build /go/src/github.com/org/repo/server /server
CMD ["/server"]

development 目标使用 golang:1.16-alpine 镜像,其中包含您开发所需的所有依赖项。您可以直接从 VS Code 启动项目并与其他应用程序或服务(如数据库或前端)交互。

在本例中,Docker Compose 文件相同。但是,它们可能不同,并且主 Compose 文件中定义的服务可以使用其他目标进行构建,或直接引用其他镜像。

下一步是什么?

了解如何 分发您的开发环境