shinsenter/debian-s6

包含s6-overlay的Linux Docker镜像

🌏 具备自动运行和s6-overlay功能的最新Linux Docker基础镜像。

目录

• 简介
• Docker镜像变体
• 使用方法
• 应用目录
• 自定义容器用户和组
• 钩子
• Autorun脚本
• 使用定时任务
• 调试模式
• 其他系统设置
• 贡献
• 许可证

简介

将官方http://hub.docker.com/_/ubuntu、http://hub.docker.com/_/debian和http://hub.docker.com/_/alpine Docker镜像与https://github.com/just-containers/s6-overlay和自动运行（autorun）机制相结合。此设置简化了跨各种架构构建可移植、生产就绪应用容器的过程。

Docker镜像变体

Docker镜像支持Debian、Ubuntu和Alpine版本。

Ubuntu

• Docker Hub: https://hub.docker.com/r/shinsenter/ubuntu-s6
• GitHub Packages: https://code.shin.company/php/pkgs/container/ubuntu-s6

Debian

• Docker Hub: https://hub.docker.com/r/shinsenter/debian-s6
• GitHub Packages: https://code.shin.company/php/pkgs/container/debian-s6

Alpine

• Docker Hub: https://hub.docker.com/r/shinsenter/alpine-s6
• GitHub Packages: https://code.shin.company/php/pkgs/container/alpine-s6

使用方法

构建并尝试以下Dockerfile示例：

Ubuntu

Dockerfile
FROM docker.xuanyuan.run/shinsenter/ubuntu-s6:latest

# 在此添加你的指令
# 例如：
# ADD --chown=$APP_USER:$APP_GROUP ./myproject/ /var/www/html/

Debian

Dockerfile
FROM docker.xuanyuan.run/shinsenter/debian-s6:latest

# 在此添加你的指令
# 例如：
# ADD --chown=$APP_USER:$APP_GROUP ./myproject/ /var/www/html/

Alpine

Dockerfile
FROM docker.xuanyuan.run/shinsenter/alpine-s6:latest

# 在此添加你的指令
# 例如：
# ADD --chown=$APP_USER:$APP_GROUP ./myproject/ /var/www/html/

应用目录

默认应用目录为/var/www/html，可通过$APP_PATH环境变量自定义：

shell
docker run -v "$PWD":/app -e APP_PATH=/app docker.xuanyuan.run/shinsenter/debian-s6:latest

此命令将Web应用目录修改为/app。

自定义容器用户和组

运行容器时通过设置环境变量覆盖默认用户和组设置。

可用变量：

例如，以用户myapp（UID为5000）运行容器：

shell
docker run -e APP_USER=myapp -e APP_UID=5000 docker.xuanyuan.run/shinsenter/debian-s6:latest

或在docker-compose.yml中：

yaml
services:
  web:
    image: docker.xuanyuan.run/shinsenter/debian-s6:latest
    environment:
      APP_USER: "myapp"
      APP_UID: "5000"

钩子

钩子用于自定义运行中容器的行为。
这些镜像支持以下钩子：

要使用钩子，在$APP_PATH内创建hooks文件夹，并添加与钩子同名的可执行文件，或在同名子文件夹中添加文件。例如：要在first-run时安装PHP模块，添加脚本hooks/first-run或hooks/first-run/install-modules。

设置DEBUG=1可查看执行的钩子。

Autorun脚本

放置在/startup/目录中的Shell脚本会在容器启动时按文件名字母顺序自动运行。此功能可在主程序运行前初始化项目，自动执行初始化脚本以节省时间。

使用示例

通过Dockerfile将名为00-migration的脚本复制到/startup/：

注意：确保脚本具有可执行权限。

Dockerfile
FROM docker.xuanyuan.run/shinsenter/debian-s6:latest

ADD ./autorun/00-migration /startup/00-migration
RUN chmod +x /startup/00-migration

# 在此添加你的指令
# 例如：
# ADD --chown=$APP_USER:$APP_GROUP ./myproject/ /var/www/html/

👉🏻 信息：启动目录已包含名为99-greeting的脚本，容器启动时会打印欢迎消息。

禁用Autorun脚本

要禁用autorun脚本，设置环境变量DISABLE_AUTORUN_SCRIPTS=1。

例如，使用docker run：

shell
docker run -e DISABLE_AUTORUN_SCRIPTS=1 docker.xuanyuan.run/shinsenter/debian-s6:latest bash

或在docker-compose.yml中：

yaml
services:
  web:
    image: docker.xuanyuan.run/shinsenter/debian-s6:latest
    environment:
      DISABLE_AUTORUN_SCRIPTS: "1"

使用定时任务

注意：这是辅助功能。如果需要基本crontab功能之外的高级功能，请考虑构建自己的Docker镜像并安装更适合的调度工具（如https://github.com/aptible/supercronic）。

要在容器中启用定时任务，可使用ENABLE_CRONTAB=1启动容器。此设置会激活Crontab服务，从$CRONTAB_DIR（默认/etc/crontab.d）加载配置。

定时任务将以$APP_USER:$APP_GROUP（默认www-data:www-data）用户身份运行，$HOME目录由$CRONTAB_HOME（默认$APP_PATH）设置。

以下是添加定时任务的Dockerfile示例：

Dockerfile
FROM docker.xuanyuan.run/shinsenter/debian-s6:latest

ENV ENABLE_CRONTAB=1

# 通过RUN指令创建定时任务
RUN echo '* * * * * echo "每分钟运行此命令！" | tee /tmp/cron-every-minute.txt' >> /etc/crontab.d/sample1;

# 或通过ADD指令复制定时任务
ADD ./sample2 /etc/crontab.d/

定时任务格式如下：

# 任务定义：
# .---------------- 分钟 (0 - 59)
# |  .------------- 小时 (0 - 23)
# |  |  .---------- 日 (1 - 31)
# |  |  |  .------- 月 (1 - 12) 或 jan,feb,mar,apr...
# |  |  |  |  .---- 星期 (0 - 6) (周日=0或7) 或 sun,mon,tue,wed,thu,fri,sat
# |  |  |  |  |
# *  *  *  *  *  要执行的命令

也可在docker-compose.yml中通过$CRONTAB_SETTINGS环境变量设置定时任务，容器启动时会加载这些设置，便于后续修改：

yaml
services:
  web:
    image: docker.xuanyuan.run/shinsenter/debian-s6:latest
    environment:
      ENABLE_CRONTAB: "1"
      CRONTAB_SETTINGS: "* * * * * echo '每分钟运行此命令！' | tee /tmp/cron-every-minute.txt"

有关定时任务的环境变量详情，见下文其他系统设置。

调试模式

设置环境变量DEBUG=1启用“调试模式”以获取更详细的日志，可用于docker run或docker-compose.yml。

命令行

shell
docker run -e DEBUG=1 docker.xuanyuan.run/shinsenter/debian-s6:latest bash

docker-compose.yml

yaml
services:
  web:
    image: docker.xuanyuan.run/shinsenter/debian-s6:latest
    environment:
      DEBUG: "1"

其他系统设置

这些Docker镜像包含其他环境变量用于微调容器行为：

贡献

如果觉得这些镜像有用，可通过***，或在https://code.shin.company/php/issues/new提交issue。

你的支持将帮助维护和改进这些社区镜像。

许可证

本项目采用https://code.shin.company/php/blob/main/LICENSE授权。

请尊重创建这些镜像的智力成果。如复制或使用本项目的想法，感谢注明出处。

---

来自越南🇻🇳的爱心奉献。