合肥网站开发培训,手机端网站建设要点,企业免费网站系统下载地址,工程公司是做什么的本文为官方文档直译版本。原文链接 Spring Boot Docker Compose 支持中文文档 引言服务连接自定义镜像跳过特定的容器使用特定Compose文件等待容器就绪控制 Docker Compose 的生命周期激活 Docker Compose 配置文件 引言
Docker Compose 是一种流行的技术#xff0c;可用于为… 本文为官方文档直译版本。原文链接 Spring Boot Docker Compose 支持中文文档 引言服务连接自定义镜像跳过特定的容器使用特定Compose文件等待容器就绪控制 Docker Compose 的生命周期激活 Docker Compose 配置文件 引言
Docker Compose 是一种流行的技术可用于为应用程序所需的服务定义和管理多个容器。通常会在应用程序旁边创建一个 compose.yml 文件用于定义和配置服务容器。 使用 Docker Compose 的典型工作流程是运行 docker compose up在应用程序中连接已启动的服务完成后再运行 docker compose down。 Spring-boot-docker-compose 模块可以包含在项目中为使用 Docker Compose 处理容器提供支持。将模块依赖关系添加到你的构建中如以下列表中的 Maven 和 Gradle 所示
dependenciesdependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-docker-compose/artifactIdoptionaltrue/optional/dependency
/dependenciesdependencies {developmentOnly(org.springframework.boot:spring-boot-docker-compose)
}为了让 Spring Boot 支持正常工作路径上必须有 docker compose 或 docker-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 onActiveMQConnectionDetails名为 “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.0ports:- 6379labels:org.springframework.boot.service-connection: redis跳过特定的容器
如果您在 compose.yml 中定义了一个容器映像但不想将其连接到您的应用程序您可以使用标签来忽略它。任何带有 org.springframework.boot.ignore 标签的容器都会被 Spring Boot 忽略。 例如
services:redis:image: redis:7.0ports:- 6379labels:org.springframework.boot.ignore: true使用特定Compose文件
如果编译文件与应用程序不在同一目录下或者文件名不同可以在 application.properties 或 application.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.0ports:- 6379labels:org.springframework.boot.readiness-check.tcp.disable: true您还可以在 application.properties 或 application.yaml 文件中更改超时值
spring:docker:compose:readiness:tcp:connect-timeout: 10sread-timeout: 5s整体超时可使用 spring.docker.compose.readiness.timeout 进行配置。
控制 Docker Compose 的生命周期
默认情况下Spring Boot 会在应用程序启动时调用 docker compose up在关闭时调用 docker compose stop。如果你希望使用不同的生命周期管理可以使用 spring.docker.compose.lifecycle-management 属性。 支持以下值
none - 不启动或停止 Docker Composestart-only - 在应用程序启动时启动 Docker Compose 并让它继续运行start-and-stop - 应用程序启动时启动 Docker ComposeJVM 退出时停止 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-stopstart:command: startstop:command: downtimeout: 1m激活 Docker Compose 配置文件
Docker Compose 配置文件与 Spring 配置文件类似可以让你针对特定环境调整 Docker Compose 配置。如果要激活特定的 Docker Compose 配置文件可以在application.properties或application.yaml 文件中使用 spring.docker.compose.profiles.active 属性
spring:docker:compose:profiles:active: myprofile
