面向初学者的 Docker 实践 Golang Dev-Golang-PHP中文网

首页

后端开发

Golang

面向初学者的 Docker 实践 Golang Dev

Susan Sarandon

Nov 04, 2024 am 05:36 AM

概述

本文不会解释 Docker 是如何在后台工作的，相反，本文将解释 Dockerfile 和 docker-compose.yml 文件中编写的每个代码的用途，以便我们可以为其他项目编写 Docker 配置。

先决条件

例如，我们需要一些带有 Dockerfile 和 docker-compose 的项目，这里我们将使用名为 Ecom 的 Golang 项目作为示例。要使用 Dockerfile，您需要按照 README 中的说明设置本地数据库。

Dockerfile

用于创建容器镜像的Dockerfile。(6)

# Build application from source
FROM golang:1.23.0 AS build-stage
    WORKDIR /app

    COPY go.mod go.sum ./
    RUN go mod download

    COPY . .

    RUN CGO_ENABLED=0 GOOS=linux go build -o /api ./cmd/main.go

登录后复制

FROM golang:1.23.0 AS 构建阶段，这是我们应用程序的镜像，它类似于我们将 Go 引擎下载到我们的机器上，Docker 需要特定的镜像来运行我们的代码。(1)(2)
WORKDIR /app 这是我们希望代码在 /app 执行的工作目录。
COPY go.mod go.sum ./ 此代码会将 go.mod 和 go.sum 文件从本地计算机复制到 Docker 上的 ./ 目录。
RUN go mod download 这将在 Docker 上执行命令 go mod download
复制。。此代码会将所有文件和文件夹项目从本地计算机复制到 Docker。
RUN CGO_ENABLED=0 GOOS=linux go build -o /api ./cmd/main.go 此代码将执行命令在 Linux 操作系统上构建 Golang 应用程序到 Docker 上的 /api 文件夹。

# Deploy application binary into a lean image
FROM scratch AS build-realease-stage
    WORKDIR /

    COPY --from=build-stage /api /api

    EXPOSE 8080

    ENTRYPOINT [ "/api" ]

登录后复制

从头开始，作为构建-发布-阶段从头开始，用于创建仅包含应用程序所需内容的最小映像。
WORKDIR / 我们将使用 root / 作为工作目录。
COPY --from=build-stage /api /api 这会将目录 /api 从镜像构建阶段复制到 build-realease-stage 镜像上的 /api。
EXPOSE 8080 这将公开端口 8080，以便我们可以在 Docker 外部使用端口 8080 访问 API。
ENTRYPOINT [ "/api" ] 这将在 /api 设置默认可执行文件

让我们试试我们的 Dockerfile。

sudo docker build .

登录后复制

docker build 将我们的项目构建成镜像。您可以添加标签 -t project-ecom 来更轻松地识别您构建的镜像。(3)

Hands On Docker For Beginners Golang Dev

您可以使用命令 sudo docker image ls 查看镜像列表

Hands On Docker For Beginners Golang Dev

# Build application from source
FROM golang:1.23.0 AS build-stage
    WORKDIR /app

    COPY go.mod go.sum ./
    RUN go mod download

    COPY . .

    RUN CGO_ENABLED=0 GOOS=linux go build -o /api ./cmd/main.go

登录后复制

然后运行我们的 Docker 镜像
--rm 停止时移除容器
--网络主机将 docker 应用程序连接到本地主机 (4),(5)
--env-file .env 通过 .env 文件访问环境值
98bc0128576e docker 镜像 ID

Hands On Docker For Beginners Golang Dev

恭喜

您现在可以测试使用 Postman 或其他应用程序使用 API。

Hands On Docker For Beginners Golang Dev

Docker 组合

Docker Compose 用于制作多个容器服务并在 Docker 内运行。在这个项目 docker-compose.yml 中，我们将解释 4 个服务。

Nginx 代理

# Build application from source
FROM golang:1.23.0 AS build-stage
    WORKDIR /app

    COPY go.mod go.sum ./
    RUN go mod download

    COPY . .

    RUN CGO_ENABLED=0 GOOS=linux go build -o /api ./cmd/main.go

登录后复制

nginx：这是服务名称
image: nginxproxy/nginx-proxy:1.6 这是我们将使用的镜像，类似于 Dockerfile 中的 FROM。
网络：这是服务将使用的 Docker 内部网络。
ports: 这是设置服务使用的端口 : , 80 是 HTTP 默认端口
Volume：这是存储该服务数据的持久卷， : ; :ro（只读）。
环境：这是使用环境变量。(8)

mysql

# Deploy application binary into a lean image
FROM scratch AS build-realease-stage
    WORKDIR /

    COPY --from=build-stage /api /api

    EXPOSE 8080

    ENTRYPOINT [ "/api" ]

登录后复制

db：这是服务名称
image: mysql:8.0 此服务使用 Image mysql 版本 8.0
网络：此服务使用名为 new 的自定义网络，然后使用别名数据库的新网络
healthcheck：这是通过运行测试来检查服务运行情况，测试：mysqladmin ping -h database -u ${DB_USER} --password=${DB_PASSWORD} 此测试 ping mysql 数据库。
Volume：这是在卷内存储持久数据。
ports：这是服务将使用的端口，在此服务中我们使用 3308 作为本地计算机端口，因为端口 3306 已用于我们本地计算机上的 mysql。
环境：这是使用环境变量，在这个mysql服务中我们需要root密码和数据库名称。(7)

迁移

sudo docker build .

登录后复制

migrate-up：这是服务名称
image: 迁移/迁移此服务使用 migrate Image
网络：此服务使用与数据库服务相同的新网络
卷：本地 ./cmd/migrate/migrations 中的迁移数据已复制到服务目录 /migrations
命令：这是在此服务上运行命令，["-path", "/migrations", "-database", "${CONNECT_DB}", "-verbose", "up"] 此命令类似于 migrate -path /migrations -database mysql://root:some-secret-password@tcp(database:3306)/ecom -verbose up。 (9)
links：将服务链接到另一个服务，此迁移服务链接到数据库服务
depends_on：这使得此服务在特定条件后执行，db：condition：service_healthy这意味着当db服务测试得到结果service_healthy时，将执行迁移服务。

应用程序编程接口

# Build application from source
FROM golang:1.23.0 AS build-stage
    WORKDIR /app

    COPY go.mod go.sum ./
    RUN go mod download

    COPY . .

    RUN CGO_ENABLED=0 GOOS=linux go build -o /api ./cmd/main.go

登录后复制

api：这是服务名称
网络：这是该服务的网络，该服务使用新的网络，因此它可以连接到服务数据库，也可以连接到服务nginx使用的默认网络。
build：这是使用 Dockerfile 构建服务。
restart：每当服务出现故障时，该服务将重新启动
Volume：这是存储在卷 /go/src/api 上的持久数据。
ports：此服务的端口。
环境：此服务所需的环境值。
links: 该服务链接到 db 服务，因为它需要使用 mysql 数据库。
depends_on：此服务将在几个条件下执行，当migrate-up时：已经service_completed_successively时，当db测试结果为service_healthy时，以及当nginx service_started时

风俗

# Deploy application binary into a lean image
FROM scratch AS build-realease-stage
    WORKDIR /

    COPY --from=build-stage /api /api

    EXPOSE 8080

    ENTRYPOINT [ "/api" ]

登录后复制

卷：创建了名为 db_data 的自定义卷：
网络：这创建了名为 new 的自定义网络

让我们尝试一下 Docker Compose

sudo docker build .

登录后复制

此命令将为每个服务创建映像并运行每个容器。

Hands On Docker For Beginners Golang Dev

sudo docker run --rm --network host --env-file .env 98bc0128576e

登录后复制

您可以查看我们的 docker-compose.yml 创建的容器。

Hands On Docker For Beginners Golang Dev

  nginx:
    image: nginxproxy/nginx-proxy:1.6
    networks:
      - default
    ports:
      - "80:80"
    volumes:
      - /var/run/docker.sock:/tmp/docker.sock:ro
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    environment:
      HTTPS_METHOD: nohttps

登录后复制

您可以检查我们创建的 docker-compose.yml 的容量。

Hands On Docker For Beginners Golang Dev

  db:
    image: mysql:8.0
    networks:
      new:
        aliases:
          - database
    healthcheck:
      test: mysqladmin ping -h database -u ${DB_USER} --password=${DB_PASSWORD}
    volumes:
      - db_data:/var/lib/mysql
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "3308:3306"
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_PASSWORD}
      MYSQL_DATABASE: ${DB_NAME}

登录后复制

您可以查看我们的 docker-compose.yml 创建的镜像。

Hands On Docker For Beginners Golang Dev

恭喜

您可以根据 README 上的文档使用 Postman 或其他应用程序测试我们项目中的 Consume API。

如果你完成了，你可以停止容器，

  migrate-up:
    image: migrate/migrate
    networks:
      - new
    volumes:
      - ./cmd/migrate/migrations:/migrations
      - /etc/timezone:/etc/timezone:ro
      - /etc/localtime:/etc/localtime:ro
    command: ["-path", "/migrations", "-database", "${CONNECT_DB}", "-verbose", "up"]
    links:
      - db
    depends_on:
      db:
        condition: service_healthy

登录后复制

Hands On Docker For Beginners Golang Dev

或者如果你想删除 docker compose 内的所有容器服务，你可以运行，

# Build application from source
FROM golang:1.23.0 AS build-stage
    WORKDIR /app

    COPY go.mod go.sum ./
    RUN go mod download

    COPY . .

    RUN CGO_ENABLED=0 GOOS=linux go build -o /api ./cmd/main.go

登录后复制

Hands On Docker For Beginners Golang Dev