孵化容器

CI/CD
包
元数据

此插件为Hatch提供支持，允许使用容器化的环境。

目录

• 安装
• 配置
  • Python
  • 镜像
  • 命令
  • 启动
  • Shell
• 注意
• 未来
• 许可证

安装

pip install hatch-containers

配置

环境插件的名称是container。

• pyproject.toml

  [tool.hatch.envs.<ENV_NAME>]
  type = "container"
  

• hatch.toml

  [envs.<ENV_NAME>]
  type = "container"
  

Python

如果将Python版本设置为多字符整数，如310，则它将被解释为它的<MAJOR>.<MINOR>形式，例如3.10。

如果没有设置，则将使用您PATH中找到的第一个python的<MAJOR>.<MINOR>版本，默认为Hatch运行的Python可执行文件。

镜像

image选项指定要使用的容器镜像，例如python:alpine。它识别占位符值{version}，它将被替换为Python选项的值。

默认值

[envs.<ENV_NAME>]
image = "python:{version}"

命令

command选项指定容器启动时将执行的命令。

默认值

[envs.<ENV_NAME>]
command = ["/bin/sleep", "infinity"]

启动

默认情况下，容器在进入环境或运行命令时将自动启动，并在启动后立即停止。如果您希望容器在创建时自动启动，并在删除前不停止，可以将start-on-creation设置为true。

默认值

[envs.<ENV_NAME>]
start-on-creation = false

Shell

shell选项指定在进入容器时使用的可执行文件。默认情况下，这设置为/bin/bash，除非镜像名称中包含alpine，在这种情况下将使用/bin/ash。

注意

• 您的PATH中必须存在docker可执行文件。
• env-exclude 环境变量过滤器没有效果。

未来

• 支持Windows容器
• 支持构建镜像

许可证

hatch-containers遵循MIT许可证条款。