|
|
|
|
公众号矩阵

在 Docker 容器中部署 Django 的时区问题

我们期望着通过在 settings.py 中配置以后,Django 就能正确地获取本地时间,但是实际上却事与愿违,我们看一看这两个设置有什么作用。

作者:Python集结号来源:今日头条|2021-10-13 08:53

现在容器化部署已经非常成熟了,我们很多服务都会使用容器部署,更新恢复都非常方便,但是有一个问题比较麻烦,就是时区处理,通常情况下,都采用注入 TZ 环境变量来解决,但是实际这种处理方式在 django 中却是不行的。

Django 中与时区有关的配置

在Django的配置文件 settings.py 中,有两个配置参数是跟时间与时区有关的,分别是TIME_ZONE和USE_TZ。我们期望着通过在 settings.py 中配置以后,Django 就能正确地获取本地时间,但是实际上却事与愿违,我们看一看这两个设置有什么作用。

USE_TZ=True

如果 USE_TZ 设置为 True 时,Django 会使用系统默认设置的时区,此时的 TIME_ZONE 的设置基本是无效的,也就是无论有没有设置都不起作用。

USE_TZ=False

如果 USE_TZ 设置为 False

  • TIME_ZONE 设置为 None
  • Django 还是会使用默认的时区
  • 若 TIME_ZONE 设置为其它时区的话
  1. 如果是 Windows 系统,则 TIME_ZONE 设置是没用的,Django会使用本机的时间
  2. 如果是其他系统,则会使用该时区的 UTC 时间

例如设置 USE_TZ = False, TIME_ZONE = ‘Asia/Shanghai’, 则使用上海的 UTC 时间。

到这一步,可能你会认为时间已经好了,但是实际上还没有,我们还需要关注系统时区的设置。

Linux 容器中时区的设置

现在我本地时间是:16:15,Django 中设置为:USE_TZ = False, TIME_ZONE = ‘Asia/Shanghai’

不注入 TZ=Asia/Shanghai 环境变量

进入容器查看容器时间和时区

在 Docker 容器中部署 Django 的时区问题

系统时间显示的是 UTC 时区,时间为:08:15,刚好差 8 个小时

进入 Django 环境查看时间和时区

  1. python manage.py shell 
  2.  
  3. from datetime import datetime 
  4. datetime.now() 
  5. # 输出 datetime.datetime(2021, 10, 8, 8, 24, 8, 289230) 
  6.  
  7. from django.utils import timezone 
  8. timezone.get_current_timezone_name() 
  9. # 输出 'Asia/Shanghai' 

注入环境变量 TZ=Asia/Shanghai

进入容器查看时间和时区

在 Docker 容器中部署 Django 的时区问题

系统时间显示的是 Asia 时区,但是时间依然是 UTC 时间,并没有显示真正的本地时间

进入 Django 环境查看时间和时区

  1. python manage.py shell 
  2.  
  3. from datetime import datetime 
  4. datetime.now() 
  5. # 输出 datetime.datetime(2021, 10, 8, 8, 24, 8, 289230) 
  6.  
  7. from django.utils import timezone 
  8. timezone.get_current_timezone_name() 
  9. # 输出 'Asia/Shanghai' 

可以看到,虽然时区变了,但是时间却还是 UTC 时间,无论是容器本身还是 Django 中

通过在网上查询,我们知道修改 Linux 系统时区要修改 /etc/localtime 文件

修改 Linux 容器时区

通常的做法是将宿主机的 /etc/localtime 文件拷贝到容器的 /etc/localtime 文件,但是我们通过查询发现 /etc/localtime 文件实际只是一个软连接,实际的文件是:/usr/share/zoneinfo/Asia/Shanghai

  1. docker cp /usr/share/zoneinfo/Asia/Shanghai test:/etc/localtime 

在不给容器注入 TZ=Asia/Shanghai 环境变量的情况下,我们登录容器发现,容器的系统时间已经正确获取到本地时间和时区了

在 Docker 容器中部署 Django 的时区问题

如果注入了 TZ=Asia/Shanghai 环境变量,即使把 /etc/localtime 文件替换了,也只是时区改变了,时间依然是 UTC 时间

进入 Django 环境查看时间

  1. python manage.py shell 
  2.  
  3. from datetime import datetime 
  4. datetime.now() 
  5. # 输出 datetime.datetime(2021, 10, 8, 8, 43, 43, 754698) 

Linux 系统时间已经正常了,但是 Django 环境中的时间还是不正确,依然是 UTC 时间,这时候很多人就有点抓狂了,可能觉得是 settings.py 中的 USE_TZ 和 TIME_ZONE 设置有问题,其实问题并不在这里。原因是因为 datetime 库会去 /usr/share/zoneinfo/ 目录下寻找 Asia/Shanghai 这个文件,而我们的镜像中不包含这个目录,所以 Django 还是使用了 UTC 时区。解决的办法非常简单:创建 /usr/share/zoneinfo/Asia 目录,拷贝文件到这个目录下就行了

  1. # 在容器内(如不不存在这个目录) 
  2. mkdir -p /usr/share/zoneinfo/Asia 
  3.  
  4. # 在容器外 
  5. docker cp /usr/share/zoneinfo/Asia/Shanghai test:/usr/share/zoneinfo/Asia/Shanghai 

然后登录到容器内,进入 Django 环境下查看时间

  1. python manage.py shell 
  2.  
  3. from datetime import datetime 
  4. datetime.now() 
  5. #输出 datetime.datetime(2021, 10, 8, 16, 49, 32, 57) 

这下时间就完全正确了。

总结

对于容器时区的问题,建议在容器制作阶段,安装并设置好 /etc/localtime,例如在 dockerfile 中添加如下语句

  1. ADD /usr/share/zoneinfo/Asia/Shanghai /usr/share/zoneinfo/Asia/Shanghai 
  2.  
  3. RUN ln -s /usr/share/zoneinfo/Asia/Shanghai /etc/localtime 

这样我们的容器在启动时就无需关注时区问题了,如果容器已经制作好了,在启动的时候挂载一下时区文件

  1. docker run -d -v /etc/localtime:/etc/localtime -v /usr/share/zoneinfo/Asia/Shanghai:/usr/share/zoneinfo/Asia/Shanghai imageName 

这种方式就比较麻烦。还有一种情况就是我们现在碰到的,服务已经上线了,发现时间有问题,就手动拷贝一下那两个文件到容器中,然后重启一下容器

  1. docker cp /usr/share/zoneinfo/Asia/Shanghai test:/etc/localtime 
  2. docker cp /usr/share/zoneinfo/Asia/Shanghai test:/usr/share/zoneinfo/Asia/Shanghai 
  3. docker restart test 

【编辑推荐】

  1. 鸿蒙官方战略合作共建——HarmonyOS技术社区
  2. 如何从Windows 10免费升级到Windows 11?
  3. Windows 11正式推送!安装方法、ISO镜像下载都在这里
  4. 突发!苹果正式关闭iOS 14.8验证系统
  5. 你升级了吗?Windows 11正式版发布 体积缩小40%
  6. 更新Windows 11了吗 为啥我到现在还没收到推送
【责任编辑:姜华 TEL:(010)68476606】

点赞 0
分享:
大家都在看
猜你喜欢
24H热文
一周话题
本月获赞

订阅专栏+更多

带你轻松入门 RabbitMQ

带你轻松入门 RabbitMQ

轻松入门RabbitMQ
共4章 | loong576

50人订阅学习

数据湖与数据仓库的分析实践攻略

数据湖与数据仓库的分析实践攻略

助力现代化数据管理:数据湖与数据仓库的分析实践攻略
共3章 | 创世达人

14人订阅学习

云原生架构实践

云原生架构实践

新技术引领移动互联网进入急速赛道
共3章 | KaliArch

42人订阅学习

订阅51CTO邮刊

点击这里查看样刊

订阅51CTO邮刊

51CTO服务号

51CTO官微