docker-日期时间-时区设置-e TZ=Asia/Shanghai

橙-极纪元JJYCheng

于 2025-04-02 08:59:44 发布

阅读量920

点赞数 13

分类专栏： Docker 文章标签： docker 容器运维

本文链接：https://blog.csdn.net/cplvfx/article/details/146642003

版权

Docker 专栏收录该内容

19 篇文章

订阅专栏

在这里插入图片描述

通过环境变量 -e TZ=Asia/Shanghai 指定时区是一种常见的方式，尤其在 Docker 容器中。它可以确保容器内的应用程序（如 Tomcat）使用正确的时区，而无需依赖宿主机的 /etc/localtime 文件。

明确概念

-e TZ=Asia/Shanghai 可以简单理解成：时区设置。
-v /etc/localtime:/etc/localtime 可以简单理解成：同步宿主机的时间设置到容器中，确保容器内时间和宿主机一致。

示例代码以及解析

docker run --name thesis_tomcat-my
  -v /home/thesis_tomcat-my/webapps:/usr/local/tomcat/webapps
  -v /home/thesis_tomcat-my/conf:/usr/local/tomcat/conf
  -v /home/thesis_tomcat-my/bin:/usr/local/tomcat/bin
  -v /home/thesis_tomcat-my/logs:/usr/local/tomcat/logs
  -v /etc/localtime:/etc/localtime
  -p 8097:8080
  -d
  --restart unless-stopped
  -e TZ=Asia/Shanghai
  tomcat:9.0.73-jdk8-corretto-al2

逐项解释

1. `docker run`

docker run 是启动一个新容器的命令。

2. `--name thesis_tomcat-my`

--name 参数为容器指定一个名称。
在这里，容器被命名为 thesis_tomcat-my，方便后续管理（如启动、停止、查看日志等）。

3. 卷挂载（`-v`）

-v 参数用于将宿主机的目录或文件挂载到容器内的指定路径。
挂载的内容和作用如下：
- -v /home/thesis_tomcat-my/webapps:/usr/local/tomcat/webapps：
  - 将宿主机的 /home/thesis_tomcat-my/webapps 目录挂载到容器内的 /usr/local/tomcat/webapps。
  - 用于存储 Tomcat 的 Web 应用程序。
- -v /home/thesis_tomcat-my/conf:/usr/local/tomcat/conf：
  - 将宿主机的 /home/thesis_tomcat-my/conf 目录挂载到容器内的 /usr/local/tomcat/conf。
  - 用于存储 Tomcat 的配置文件（如 server.xml、web.xml 等）。
- -v /home/thesis_tomcat-my/bin:/usr/local/tomcat/bin：
  - 将宿主机的 /home/thesis_tomcat-my/bin 目录挂载到容器内的 /usr/local/tomcat/bin。
  - 用于存储 Tomcat 的脚本文件（如启动脚本 catalina.sh）。
- -v /home/thesis_tomcat-my/logs:/usr/local/tomcat/logs：
  - 将宿主机的 /home/thesis_tomcat-my/logs 目录挂载到容器内的 /usr/local/tomcat/logs。
  - 用于存储 Tomcat 的日志文件。
- -v /etc/localtime:/etc/localtime：
  - 将宿主机的时间设置文件挂载到容器内，确保容器内时间和宿主机一致。

4. 端口映射（`-p`）

-p 8097:8080：
- 将宿主机的 8097 端口映射到容器内的 8080 端口。
- 用户可以通过访问宿主机的 8097 端口来访问 Tomcat 的服务。

5. 后台运行（`-d`）

-d：
- 表示以分离模式（后台运行）启动容器。
- 容器启动后不会占用当前终端，而是以后台进程的形式运行。

6. 重启策略（`--restart unless-stopped`）

--restart unless-stopped：
- 设置容器的重启策略为 unless-stopped。
- 这意味着：
  - 如果 Docker 服务重启（例如系统重启），容器会自动启动。
  - 如果容器被手动停止（使用 docker stop），则不会自动重启。

7. 环境变量（`-e TZ=Asia/Shanghai`）

-e TZ=Asia/Shanghai：
- 设置环境变量 TZ 的值为 Asia/Shanghai。
- 这会告诉容器使用中国上海的时区（东八区，UTC+8）。
- 容器内的应用程序（如 Tomcat 和 Java）会根据该环境变量调整时间。

8. 镜像（`tomcat:9.0.73-jdk8-corretto-al2`）

使用官方的 tomcat:9.0.73-jdk8-corretto-al2 镜像。
这是一个基于 Amazon Corretto JDK 8 的 Tomcat 9.0.73 镜像。
它包含了运行 Tomcat 所需的所有依赖。

总体功能

该命令的作用是启动一个名为 thesis_tomcat-my 的 Tomcat 容器，主要功能包括：

数据持久化：
- 通过挂载宿主机的目录，确保容器内的 Web 应用程序、配置文件、脚本和日志文件在容器重启或删除后仍然保留。
端口映射：
- 宿主机的 8097 端口映射到容器的 8080 端口，允许用户通过宿主机的 8097 端口访问 Tomcat 服务。
后台运行：
- 容器以后台模式运行，不会占用当前终端。
自动重启：
- 设置了 --restart unless-stopped 策略，确保容器在 Docker 服务重启后能够自动启动。
时区设置：
- 通过环境变量 TZ=Asia/Shanghai 设置容器内的时区为中国上海时间（UTC+8）。
镜像使用：
- 使用官方的 tomcat:9.0.73-jdk8-corretto-al2 镜像，确保容器运行的是稳定版本的 Tomcat 和 JDK。

时区同步：

时区同步：
- 虽然挂载了 /etc/localtime，但如果您需要更灵活的时区设置，可以考虑通过环境变量 -e TZ=Asia/Shanghai 来指定时区。

在您的原有命令基础上，添加 -e TZ=Asia/Shanghai 环境变量即可：

docker run --name thesis_tomcat-my
  -v /home/thesis_tomcat-my/webapps:/usr/local/tomcat/webapps
  -v /home/thesis_tomcat-my/conf:/usr/local/tomcat/conf
  -v /home/thesis_tomcat-my/bin:/usr/local/tomcat/bin
  -v /home/thesis_tomcat-my/logs:/usr/local/tomcat/logs
  -v /etc/localtime:/etc/localtime
  -p 8097:8080
  -d
  --restart unless-stopped
  -e TZ=Asia/Shanghai
  tomcat:9.0.73-jdk8-corretto-al2

具体说明

-e TZ=Asia/Shanghai
- TZ 是一个标准的环境变量，用于指定时区。
- Asia/Shanghai 表示中国上海的时区（即东八区，UTC+8）。
- 这个环境变量会被容器内的操作系统和应用程序（如 Java 和 Tomcat）识别，并自动调整时间。
移除 -v /etc/localtime:/etc/localtime（可选）
- 如果您已经通过 -e TZ=Asia/Shanghai 指定了时区，则可以移除 -v /etc/localtime:/etc/localtime，因为环境变量的方式更加灵活且不依赖宿主机的具体文件。

验证时区设置是否生效

启动容器后，可以通过以下方式验证时区是否正确设置：

进入容器：使用 docker exec 命令进入容器：
```
docker exec -it thesis_tomcat17xyvtc /bin/bash
```
检查时区：在容器内运行以下命令，查看当前时间和时区：
```
date
```
输出的时间应该显示为东八区时间（例如：CST 或 UTC+8）。
检查环境变量：在容器内运行以下命令，确认 TZ 环境变量是否正确设置：
```
echo $TZ
```
输出应为：
```
Asia/Shanghai
```

注意事项

镜像支持：
- 大多数官方镜像（如 tomcat）都支持通过 TZ 环境变量设置时区。
- 如果您使用的是自定义镜像，请确保镜像中支持 TZ 环境变量（通常需要安装 tzdata 包）。
Java 应用程序的时区：
- Java 应用程序（如 Tomcat）会优先读取 TZ 环境变量来设置时区。
- 如果 TZ 环境变量未设置，Java 可能会回退到默认的 UTC 时间。
其他时区：
- 如果需要其他时区，可以参考
  IANA Time Zone Database
  中的时区名称。例如：
  - Europe/London
  - America/New_York
  - Australia/Sydney