Drone-Runner 环境变量
drone环境变量
参考资料
注意事项
- 文档翻译为Deepl机翻。
- 默认值:无,仅表示翻译过程中并未直接指出该环境变量的值是什么。
- 此翻译,仅供参数。
- docker镜像版本为
drone/drone-runner-docker:1
下环境变量解释。
环境变量
DRONE_CPU_PERIOD
描述 定义 环境变量 DRONE_CPU_PERIOD 解释 可选的整数值。指定CPU CFS调度器的周期,与CPU配额一起使用。 默认值 无 示例 DRONE_CPU_PERIOD=100000 DRONE_CPU_QUOTA
描述 定义 环境变量 DRONE_CPU_QUOTA 解释 可选的整数值。对所有管道容器施加一个CPU CFS配额。容器在节流之前,每一个CPU周期的微秒数限制。 默认值 无 示例 DRONE_CPU_QUOTA=100 DRONE_CPU_SET
描述 定义 环境变量 DRONE_CPU_SET 解释 可选的逗号分隔的字符串值。限制一个管道容器可以使用的特定CPU或核心。 默认值 无 示例 DRONE_CPU_SET=1,3 DRONE_CPU_SHARES
描述 定义 环境变量 DRONE_CPU_SHARES 解释 可选的整数值。将此标志设置为大于或小于默认值1024的值,以增加或减少管道容器的重量,并使其能够获得更大或更小比例的主机CPU周期。 默认值 无 示例 DRONE_CPU_SHARES=1024 DRONE_DEBUG
描述 定义 环境变量 DRONE_DEBUG 解释 可选的布尔值。启用调试级别的日志记录。 默认值 无 示例 DRONE_DEBUG=true DRONE_DEFER_TAIL_LOG
描述 定义 环境变量 DRONE_DEFER_TAIL_LOG 解释 可选的布尔值。启用新的日志生命周期,以帮助防止日志被截断。在1.8.1版本中可用。 默认值 无 示例 DRONE_DEFER_TAIL_LOG=true DRONE_DOCKER_CONFIG
描述 定义 环境变量 DRONE_DOCKER_CONFIG 解释 可选的字符串值。提供Docker config.json文件的路径,用于从第三方系统中获取注册表的凭证。 请注意,你通常需要把这个文件从主机装入你的Docker容器。注意上面定义的配置路径应该指向容器内的文件路径。 默认值 示例 DRONE_DOCKER_CONFIG=/root/.docker/config.json docker run –volume /root/.docker/config.json:/root/.docker/config.json DRONE_DOCKER_NETWORK_ID
描述 定义 环境变量 DRONE_DOCKER_NETWORK_ID 解释 可选的字符串值。指定要创建的docker网络的名称。默认情况下,它是一个随机字符串。 默认值 无 示例 DRONE_DOCKER_NETWORK_ID=named_network DRONE_DOCKER_STREAM_PULL
描述 定义 环境变量 DRONE_DOCKER_STREAM_PULL 解释 可选的布尔值。禁止将Docker pull的输出写到构建日志中。 默认值 true 示例 DRONE_DOCKER_STREAM_PULL=true DRONE_ENV_PLUGIN_ENDPOINT
描述 定义 环境变量 DRONE_ENV_PLUGIN_ENDPOINT 解释 可选的字符串值。提供用于向外部环境变量插件发出http请求的端点。外部环境变量插件可用于从第三方系统获取自定义管道环境变量。 默认值 无 示例 DRONE_ENV_PLUGIN_ENDPOINT= http://1.2.3.4:3000
DRONE_ENV_PLUGIN_SKIP_VERIFY
描述 定义 环境变量 DRONE_ENV_PLUGIN_SKIP_VERIFY 解释 可选的布尔值。在向插件端点发出http请求时禁用SSL验证。这是不安全的,不推荐。 默认值 无 示例 DRONE_ENV_PLUGIN_SKIP_VERIFY=false DRONE_ENV_PLUGIN_TOKEN
描述 定义 环境变量 DRONE_ENV_PLUGIN_TOKEN 解释 可选的字符串值。提供用于验证对插件端点的http请求的秘密令牌。 默认值 无 示例 DRONE_ENV_PLUGIN_TOKEN=bea26a2221fd8090ea38720fc445eca6 DRONE_HTTP_BIND
描述 定义 环境变量 DRONE_HTTP_BIND 解释 可选的字符串值用于配置http监听器的端口。默认值是:3000。不建议重写这个值。 默认值 3000 示例 DRONE_HTTP_BIND=:3000 DRONE_HTTP_HOST
描述 定义 环境变量 DRONE_HTTP_HOST 解释 可选的字符串值,用于配置http监听器的主机名。默认值是一个空字符串。不建议设置此值。 默认值 ""
示例 DRONE_HTTP_HOST=runner.company.com:3000 DRONE_HTTP_PROTO
描述 定义 环境变量 DRONE_HTTP_PROTO 解释 可选的字符串值用于配置http监听器协议。默认值是http。不建议重写这个值。 默认值 http 示例 DRONE_HTTP_PROTO=http DRONE_LIMIT_EVENTS
描述 定义 环境变量 DRONE_LIMIT_EVENTS 解释 可选的逗号分隔的字符串值。提供可由该运行器处理的构建事件的白名单。这提供了一个额外的安全层,以限制该运行器可以处理的工作负载的种类。 默认值 无 示例 DRONE_LIMIT_EVENTS=push,tag DRONE_LIMIT_REPOS
描述 定义 环境变量 DRONE_LIMIT_REPOS 解释 可选的逗号分隔的字符串值。配置运行器,使其只处理匹配的存储库。这提供了一个额外的安全层,可以阻止不受信任的存储库使用该运行器执行管道。 默认值 无 示例 DRONE_LIMIT_REPOS=octocat/hello-world,spaceghost/* DRONE_LIMIT_TRUSTED
描述 定义 环境变量 DRONE_LIMIT_TRUSTED 解释 可选的布尔值。配置运行器,使其只处理受信任的存储库。这提供了一个额外的安全层,可以阻止不受信任的存储库与该运行器一起执行管道。 默认值 无 示例 DRONE_LIMIT_TRUSTED=true DRONE_MEMORY_LIMIT
描述 定义 环境变量 DRONE_MEMORY_LIMIT 解释 可选的整数值。单个流水线容器可以使用的最大内存量,以字节为单位配置。 默认值 无 示例 DRONE_MEMORY_LIMIT=500000000 DRONE_MEMORY_SWAP_LIMIT
描述 定义 环境变量 DRONE_MEMORY_SWAP_LIMIT 解释 可选的整数值。允许单个流水线容器交换到磁盘的最大内存量,以字节为单位进行配置。 默认值 无 示例 DRONE_MEMORY_SWAP_LIMIT=500000000 DRONE_NETRC_CLONE_ONLY
描述 定义 环境变量 DRONE_NETRC_CLONE_ONLY 解释 可选的布尔值。配置运行器,使其仅在克隆步骤中注入克隆凭证。请注意,如果版本库是私有的或需要认证才能克隆,Drone 会将克隆凭证注入所有管道步骤;如果版本库是公共的,Drone 不会将凭证注入管道步骤。 默认值 无 示例 DRONE_NETRC_CLONE_ONLY=true DRONE_REGISTRY_PLUGIN_ENDPOINT
描述 定义 环境变量 DRONE_REGISTRY_PLUGIN_ENDPOINT 解释 可选的字符串值。提供用于向外部注册表插件发出http请求的端点。外部注册表插件可用于从第三方系统获取注册表凭证。 默认值 无 示例 DRONE_REGISTRY_PLUGIN_ENDPOINT= http://1.2.3.4:3000
DRONE_REGISTRY_PLUGIN_SKIP_VERIFY
描述 定义 环境变量 DRONE_REGISTRY_PLUGIN_SKIP_VERIFY 解释 可选的布尔值。在向注册表插件端点发出http请求时禁用SSL验证。这是不安全的,不推荐。 默认值 无 示例 DRONE_REGISTRY_PLUGIN_SKIP_VERIFY=false DRONE_REGISTRY_PLUGIN_TOKEN
描述 定义 环境变量 DRONE_REGISTRY_PLUGIN_TOKEN 解释 可选的字符串值。提供用于验证对注册表插件端点的http请求的令牌。 默认值 无 示例 DRONE_REGISTRY_PLUGIN_TOKEN=bea26a2221fd8090ea38720fc445eca6 DRONE_RPC_DUMP_HTTP
描述 定义 环境变量 DRONE_RPC_DUMP_HTTP 解释 可选的布尔值。启用将http请求和响应转储到日志中的功能,以便进行调试。这应该只在调试运行器和服务器之间的连接问题时启用 默认值 无 示例 DRONE_RPC_DUMP_HTTP=true DRONE_RPC_DUMP_HTTP_BODY
描述 定义 环境变量 DRONE_RPC_DUMP_HTTP_BODY 解释 可选的布尔值。启用将http请求和响应体转储到日志中以进行调试。这应该只在调试运行器和服务器之间的连接问题时启用。 默认值 无 示例 DRONE_RPC_DUMP_HTTP_BODY=true DRONE_RPC_HOST
描述 定义 环境变量 DRONE_RPC_HOST 解释 必要的字符串值。定义用于连接Drone服务器的主机名(和可选端口)。 默认值 无 示例 DRONE_RPC_HOST=drone.company.com DRONE_RPC_PROTO
描述 定义 环境变量 DRONE_RPC_PROTO 解释 必要的字符串值。定义用于连接Drone服务器的协议。该值必须是 http 或 https。 默认值 无 示例 DRONE_RPC_PROTO=https DRONE_RPC_SECRET
描述 定义 环境变量 DRONE_RPC_SECRET 解释 必要的字符串值。提供Drone服务器用于验证http请求的共享秘密。 默认值 无 示例 DRONE_RPC_SECRET=bea26a2221fd8090ea38720fc445eca6 DRONE_RPC_SKIP_VERIFY
描述 定义 环境变量 DRONE_RPC_SKIP_VERIFY 解释 可选的布尔值。在向Drone服务器发出http请求时禁用SSL验证。这是不安全的,不建议使用。 默认值 无 示例 DRONE_RPC_SKIP_VERIFY=false DRONE_RUNNER_CAPACITY
描述 定义 环境变量 DRONE_RUNNER_CAPACITY 解释 可选的数字值。限制运行器可以执行的并发管线的数量。运行器默认执行2条并发管道。 默认值 2 示例 DRONE_RUNNER_CAPACITY=10 DRONE_RUNNER_CLONE_IMAGE
描述 定义 环境变量 DRONE_RUNNER_CLONE_IMAGE 解释 可选的字符串值。覆盖用于克隆版本库的Docker镜像。 默认值 无 示例 DRONE_RUNNER_CLONE_IMAGE=drone/git:1 DRONE_RUNNER_DEVICES
描述 定义 环境变量 DRONE_RUNNER_DEVICES 解释 可选的逗号分隔的列表。提供被安装到每个管道步骤中的设备的列表。 默认值 无 示例 DRONE_RUNNER_DEVICES=/dev/sdb DRONE_RUNNER_ENV_FILE
描述 定义 环境变量 DRONE_RUNNER_ENV_FILE 解释 可选的字符串值。提供环境变量文件的路径,用于定义注入所有管道步骤中的全局环境变量。这里记录了环境文件的格式。 默认值 无 示例 DRONE_RUNNER_ENV_FILE=/etc/drone.conf 记住要把这个文件从主机装入Docker容器。注意上面定义的配置路径应该指向容器内的文件路径。 docker run –volume /etc/drone.conf:/etc/drone.conf DRONE_RUNNER_ENVIRON
描述 定义 环境变量 DRONE_RUNNER_ENVIRON 解释 可选的字符串映射。提供一组注入到每个管道步骤的全局环境变量。 默认值 无 示例 DRONE_RUNNER_ENVIRON=foo:bar,baz:qux DRONE_RUNNER_LABELS
描述 定义 环境变量 DRONE_RUNNER_LABELS 解释 可选的字符串映射。提供一组标签,用于将管道路由到特定机器或一组机器。 默认值 无 示例 DRONE_RUNNER_LABELS=foo:bar,baz:qux DRONE_RUNNER_MAX_PROCS
描述 定义 环境变量 DRONE_RUNNER_MAX_PROCS 解释 可选的数字值。限制一个运行器可以为一个管道执行的并发步骤的数量。这在默认情况下是禁用的。如果你需要节制最大的并行步骤数量以防止资源耗尽,这可能是有用的。 默认值 0 示例 DRONE_RUNNER_MAX_PROCS=10 DRONE_RUNNER_NAME
描述 定义 环境变量 DRONE_RUNNER_NAME 解释 可选的字符串值。设置运行器的名称。跑步者的名字存储在服务器中,可以用来追溯到一个特定的跑步者。 默认值 无 示例 DRONE_RUNNER_NAME=ec2-43-21.us-east-1.compute.amazonaws.com DRONE_RUNNER_NETWORKS
描述 定义 环境变量 DRONE_RUNNER_NETWORKS 解释 可选的逗号分隔的列表。提供连接到每个管道步骤的Docker网络的列表。 默认值 无 示例 DRONE_RUNNER_NETWORKS=networkA,networkB DRONE_RUNNER_PRIVILEGED_IMAGES
描述 定义 环境变量 DRONE_RUNNER_PRIVILEGED_IMAGES 解释 可选的逗号分隔的列表。提供一个默认作为特权容器启动的Docker镜像的列表。特权模式有效地授予容器对主机的根权限。请慎重使用 默认值 无 示例 DRONE_RUNNER_PRIVILEGED_IMAGES=plugins/docker,plugin/ecr DRONE_RUNNER_SECRETS
描述 定义 环境变量 DRONE_RUNNER_SECRETS 解释 可选的字符串映射。提供一组全局的、命名的秘密,供所有管道使用。 默认值 无 示例 DRONE_RUNNER_SECRETS=username:bar,password:qux DRONE_RUNNER_VOLUMES
描述 定义 环境变量 DRONE_RUNNER_VOLUMES 解释 可选的逗号分隔的列表。提供挂载到每个管道步骤中的Docker卷的列表。在下面的例子中,冒号左边的路径是主机的路径。右边的路径是你的管道容器内的路径 默认值 无 示例 DRONE_RUNNER_VOLUMES=/path/on/host:/path/in/container DRONE_SECRET_PLUGIN_ENDPOINT
描述 定义 环境变量 DRONE_SECRET_PLUGIN_ENDPOINT 解释 可选的字符串值。提供用于向外部秘密插件发出http请求的端点。外部秘密插件(如vault)可用于从第三方系统获取秘密。 默认值 无 示例 DRONE_SECRET_PLUGIN_ENDPOINT= http://1.2.3.4:3000
DRONE_SECRET_PLUGIN_SKIP_VERIFY
描述 定义 环境变量 DRONE_SECRET_PLUGIN_SKIP_VERIFY 解释 可选的布尔值。在向插件端点发出http请求时禁用SSL验证。这是不安全的,不推荐。 默认值 无 示例 DRONE_SECRET_PLUGIN_SKIP_VERIFY=false DRONE_SECRET_PLUGIN_TOKEN
描述 定义 环境变量 DRONE_SECRET_PLUGIN_TOKEN 解释 可选的字符串值。提供用于验证对插件端点的http请求的秘密令牌。 默认值 无 示例 DRONE_SECRET_PLUGIN_TOKEN=bea26a2221fd8090ea38720fc445eca6 DRONE_TMATE_ENABLED
描述 定义 环境变量 DRONE_TMATE_ENABLED 解释 可选的布尔值。启用使用tmate的管道容器的远程ssh访问。托管服务和自我托管服务都被支持。这个功能默认是禁用的。这个功能需要1.6.1版本的docker runner和更高版本。 默认值 false 示例 DRONE_TMATE_ENABLED=true 请注意,你也可以使用下面的配置参数来配置一个自我托管的tmate服务器。请参阅官方的tmate文档以了解更多关于自我托管tmate服务器的信息。 DRONE_TMATE_ENABLED=true
DRONE_TMATE_HOST=tmate.company.com
DRONE_TMATE_PORT=2200
DRONE_TMATE_FINGERPRINT_RSA=SHA256:iL3StSCmPU+7p2IoD8y0huMXRVFIZyGFZa8r+lO3U5I
DRONE_TMATE_FINGERPRINT_ED25519=SHA256:gXLaN8IUxUMmlm/xu7M2NEFMlbUr5UORUgMi86Kh+tI
DRONE_TRACE
描述 定义 环境变量 DRONE_TRACE 解释 可选的布尔值。启用跟踪级别的日志记录。 默认值 无 示例 DRONE_TRACE=true DRONE_UI_DISABLED
描述 定义 环境变量 DRONE_UI_DISABLED 解释 可选的布尔值。禁用运行器的用户界面。 默认值 无 示例 DRONE_UI_DISABLE=true DRONE_UI_PASSWORD
描述 定义 环境变量 DRONE_UI_PASSWORD 解释 可选的字符串值。设置基本认证密码,用于认证和访问网络仪表板。如果没有提供密码,网络仪表板将被禁用。 默认值 无 示例 DRONE_UI_PASSWORD=root DRONE_UI_REALM
描述 定义 环境变量 DRONE_UI_REALM 解释 可选的字符串值。设置用于验证和访问网络仪表板的基本认证境界。 默认值 无 示例 DRONE_UI_REALM=DroneRealm DRONE_UI_USERNAME
描述 定义 环境变量 DRONE_UI_USERNAME 解释 可选的字符串值。设置用于验证和访问网络仪表板的基本认证用户名。 默认值 无 示例 DRONE_UI_USERNAME=root