设置开发环境

重要

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

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

Docker Desktop 4.13 中开发环境的更改

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

如果您使用的是 `.docker/docker-compose.yaml`,我们将将其移动到 `../compose-dev.yaml`。如果您使用的是 `.docker/config.json`,我们将创建一个名为“app”的单一服务的 `../compose-dev.yaml` 文件。它被配置为使用 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 文件中定义的服务可以使用其他目标进行构建或直接引用其他镜像。

下一步是什么?

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