shinsenter/ubuntu-s6

带有s6-overlay的Linux Docker镜像

目录

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

简介

结合官方的http://hub.docker.com/_/ubuntu%E3%80%81http://hub.docker.com/_/debian%E5%92%8Chttp://hub.docker.com/_/alpine Docker镜像，集成https://github.com/just-containers/s6-overlay%E5%92%8C%E8%87%AA%E5%8A%A8%E8%BF%90%E8%A1%8C%E6%9C%BA%E5%88%B6%E3%80%82%E6%AD%A4%E8%AE%BE%E7%BD%AE%E7%AE%80%E5%8C%96%E4%BA%86%E8%B7%A8%E5%A4%9A%E7%A7%8D%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E5%8F%AF%E7%A7%BB%E6%A4%8D%E3%80%81%E7%94%9F%E4%BA%A7%E5%B0%B1%E7%BB%AA%E7%9A%84%E5%BA%94%E7%94%A8%E5%AE%B9%E5%99%A8%E7%9A%84%E8%BF%87%E7%A8%8B%E3%80%82

Docker镜像变体

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

Ubuntu

• Docker Hub: https://hub.docker.com/r/shinsenter/ubuntu-s6
• GitHub Packages: [***]

Debian

• Docker Hub: https://hub.docker.com/r/shinsenter/debian-s6
• GitHub Packages: [***]

Alpine

• Docker Hub: https://hub.docker.com/r/shinsenter/alpine-s6
• GitHub Packages: [***]

使用方法

构建并尝试以下Dockerfile示例：

Ubuntu

Dockerfile
FROM shinsenter/ubuntu-s6:latest

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

Debian

Dockerfile
FROM shinsenter/debian-s6:latest

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

Alpine

Dockerfile
FROM 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 shinsenter/debian-s6:latest

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

自定义容器用户和组

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

可用变量：

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

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

或在docker-compose.yml中：

yaml
services:
  web:
    image: 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可查看执行的钩子。

自动运行脚本

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

使用示例

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

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

Dockerfile
FROM 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的脚本，容器启动时会打印欢迎消息。

禁用自动运行脚本

要禁用自动运行脚本，设置环境变量DISABLE_AUTORUN_SCRIPTS=1。

例如，使用docker run：

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

或在docker-compose.yml中：

yaml
services:
  web:
    image: shinsenter/debian-s6:latest
    environment:
      DISABLE_AUTORUN_SCRIPTS: "1"

使用定时任务

注意：这是一项辅助功能。如果您需要基本crontab功能之外的更高级功能，请考虑构建自己的Docker镜像并安装更适合您需求的替代调度工具（例如https://github.com/aptible/supercronic%EF%BC%89%E3%80%82

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

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

以下是添加crontab的Dockerfile示例：

Dockerfile
FROM shinsenter/debian-s6:latest

ENV ENABLE_CRONTAB=1

# 通过RUN指令创建crontab条目
RUN echo '* * * * * echo "This line will run every minute!" | tee /tmp/cron-every-minute.txt' >> /etc/crontab.d/sample1;

# 或通过ADD指令复制crontab条目
ADD ./sample2 /etc/crontab.d/

crontab条目的格式如下：

# 任务定义：
# .---------------- 分钟 (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环境变量轻松设置定时任务。容器启动时，这些设置会加载到crontab中，便于后续修改。

yaml
services:
  web:
    image: shinsenter/debian-s6:latest
    environment:
      ENABLE_CRONTAB: "1"
      CRONTAB_SETTINGS: "* * * * * echo 'This line will run every minute!' | tee /tmp/cron-every-minute.txt"

有关定时任务的环境变量详情，请参见下面的其他系统设置部分。

Debug模式

通过设置环境变量DEBUG=1启用"调试模式"以获取更详细的日志。可在docker run和docker-compose.yml中使用。

命令行

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

docker-compose.yml

yaml
services:
  web:
    image: shinsenter/debian-s6:latest
    environment:
      DEBUG: "1"

其他系统设置

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

贡献

如果您觉得这些镜像有用，可通过***，或在GitHub提交issue。您的支持有助于维护和改进这些社区镜像。

许可证

本项目根据GNU General Public License v3.0许可。请尊重创建这些镜像所涉及的智力成果。如果您打算复制或使用本项目的想法，感谢您给予适当的引用。

---

来自越南 🇻🇳 的爱。