Spring Boot Docker Compose 支持中文文档

发布时间:2023年12月18日

本文为官方文档直译版本。原文链接

引言

Docker Compose 是一种流行的技术,可用于为应用程序所需的服务定义和管理多个容器。通常会在应用程序旁边创建一个 compose.yml 文件,用于定义和配置服务容器。
使用 Docker Compose 的典型工作流程是:运行 docker compose up,在应用程序中连接已启动的服务,完成后再运行 docker compose down
Spring-boot-docker-compose 模块可以包含在项目中,为使用 Docker Compose 处理容器提供支持。将模块依赖关系添加到你的构建中,如以下列表中的 Maven 和 Gradle 所示:

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-docker-compose</artifactId>
        <optional>true</optional>
    </dependency>
</dependencies>
dependencies {
    developmentOnly("org.springframework.boot:spring-boot-docker-compose")
}

为了让 Spring Boot 支持正常工作,路径上必须有 docker composedocker-compose CLI 应用程序。

当该模块作为依赖关系包含时,Spring Boot 将执行以下操作:

  • 在应用程序目录中搜索 compose.yml 和其他常见的 compose 文件名
  • 使用发现的 compose.yml 调用 docker compose up
  • 为每个受支持的容器创建服务连接Beans
  • 当应用程序关闭时,调用 docker compose stop

如果启动应用程序时 Docker Compose 服务已在运行,Spring Boot 只会为每个受支持的容器创建服务连接Beans。它不会再次调用 docker compose up,也不会在关闭应用时调用 docker compose stop

默认情况下,运行测试时 Spring Boot 的 Docker Compose 支持是禁用的。要启用它,请将 spring.docker.compose.skip.in-tests 设置为 false

服务连接

服务连接是与任何远程服务的连接。Spring Boot 的自动配置可以获取服务连接的详细信息,并利用它们建立与远程服务的连接。这样做时,连接细节优先于任何与连接相关的配置属性。
使用 Spring Boot 的 Docker Compose 支持时,服务连接会建立到容器映射的端口。

Docker compose 的使用方式通常是将容器内的端口映射到计算机上的临时端口。例如,Postgres 服务器可以使用 5432 端口在容器内运行,但在本地却被映射到一个完全不同的端口。服务连接将始终发现并使用本地映射的端口。

服务连接是通过使用容器的映像名称建立的。目前支持以下服务连接:

Connection DetailsMatched on
ActiveMQConnectionDetails名为 “symptoma/activemq” 的容器
CassandraConnectionDetails名为 “cassandra” 的容器
ElasticsearchConnectionDetails名为 “elasticsearch” 的容器
JdbcConnectionDetails名为 “gvenzl/oracle-free”、“gvenzl/oracle-xe”、“mariadb”、“mssql/server”、"mysql "或 "postgres "的容器
MongoConnectionDetails名为 “mongo” 的容器
Neo4jConnectionDetails名为 “neo4j” 的容器
OtlpMetricsConnectionDetails名为 “otel/opentelemetry-collector-contrib” 的容器
OtlpTracingConnectionDetails名为 “otel/opentelemetry-collector-contrib” 的容器
PulsarConnectionDetails名为 “apachepulsar/pulsar” 的容器
R2dbcConnectionDetails名为 “gvenzl/oracle-free”、“gvenzl/oracle-xe”、“mariadb”、“mssql/server”、"mysql "或 "postgres "的容器
RabbitConnectionDetails名为 “rabbitmq” 的容器
RedisConnectionDetails名为 “redis” 的容器
ZipkinConnectionDetails名为 “openzipkin/zipkin” 的容器

自定义镜像

有时,您可能需要使用自己版本的镜像来提供服务。您可以使用任何自定义镜像,只要其行为方式与标准镜像相同即可。具体来说,标准镜像支持的环境变量也必须在自定义镜像中使用。
如果你的映像使用不同的名称,你可以在 compose.yml 文件中使用一个标签,这样 Spring Boot 就能提供服务连接。使用名为 org.springframework.boot.service-connection 的标签提供服务名称。
例如:

services:
  redis:
    image: 'mycompany/mycustomredis:7.0'
    ports:
      - '6379'
    labels:
      org.springframework.boot.service-connection: redis

跳过特定的容器

如果您在 compose.yml 中定义了一个容器映像,但不想将其连接到您的应用程序,您可以使用标签来忽略它。任何带有 org.springframework.boot.ignore 标签的容器都会被 Spring Boot 忽略。
例如:

services:
  redis:
    image: 'redis:7.0'
    ports:
      - '6379'
    labels:
      org.springframework.boot.ignore: true

使用特定Compose文件

如果编译文件与应用程序不在同一目录下,或者文件名不同,可以在 application.propertiesapplication.yaml 中使用 spring.docker.compose.file 指向不同的文件。属性可以定义为准确的路径,也可以定义为与应用程序相对的路径。
例如:

spring:
  docker:
    compose:
      file: "../my-compose.yml"

等待容器就绪

Docker Compose 启动的容器可能需要一段时间才能完全就绪。检查就绪状态的推荐方法是在 compose.yml 文件的服务定义下添加健康检查(healthcheck)部分。
由于在 compose.yml 文件中省略健康检查(healthcheck)配置的情况并不少见,因此 Spring Boot 也会直接检查服务是否就绪。默认情况下,当 TCP/IP 连接可以建立到映射端口时,容器就被视为就绪。
您可以在 compose.yml 文件中添加 org.springframework.boot.readiness-check.tcp.disable 标签,在每个容器上禁用此功能。
例如:

services:
  redis:
    image: 'redis:7.0'
    ports:
      - '6379'
    labels:
      org.springframework.boot.readiness-check.tcp.disable: true

您还可以在 application.propertiesapplication.yaml 文件中更改超时值:

spring:
  docker:
    compose:
      readiness:
        tcp:
          connect-timeout: 10s
          read-timeout: 5s

整体超时可使用 spring.docker.compose.readiness.timeout 进行配置。

控制 Docker Compose 的生命周期

默认情况下,Spring Boot 会在应用程序启动时调用 docker compose up,在关闭时调用 docker compose stop。如果你希望使用不同的生命周期管理,可以使用 spring.docker.compose.lifecycle-management 属性。
支持以下值:

  • none - 不启动或停止 Docker Compose
  • start-only - 在应用程序启动时启动 Docker Compose 并让它继续运行
  • start-and-stop - 应用程序启动时启动 Docker Compose,JVM 退出时停止 Docker Compose

此外,你还可以使用 spring.docker.compose.start.command 属性来更改是使用 docker compose up 还是 docker compose start。通过 spring.docker.compose.stop.command 属性,你可以配置是使用 docker compose down 还是 docker compose stop
下面的示例显示了如何配置生命周期管理:

spring:
  docker:
    compose:
      lifecycle-management: start-and-stop
      start:
        command: start
      stop:
        command: down
        timeout: 1m

激活 Docker Compose 配置文件

Docker Compose 配置文件与 Spring 配置文件类似,可以让你针对特定环境调整 Docker Compose 配置。如果要激活特定的 Docker Compose 配置文件,可以在application.propertiesapplication.yaml 文件中使用 spring.docker.compose.profiles.active 属性:

spring:
  docker:
    compose:
      profiles:
        active: "myprofile"
文章来源:https://blog.csdn.net/qq_41939901/article/details/135041632
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。