管道参数
提供了用于拉取请求,持续集成,持续部署,持续合规性和提升管道的参数。
您可以向管道 UI 上的管道添加参数,并从 定制脚本 访问这些参数。
表 1 到 5 列出并描述了管道的拉取请求,持续集成,持续部署,持续合规性和提升参数。
名称 | Type | 描述 | 必需或可选 |
---|---|---|---|
artifactory-dockerconfigjson |
Secret | base64-encoded Docker config.json 文件,用于存储 artifactory 的凭证信息。 |
可选 |
base-branch |
文本 | 在其中合并 PR 的目标分支。 通常,master 是缺省基本分支。 如果配置了 PR Git 触发器 (通常如此),那么将从触发器填充此参数。 |
必需 |
base-repo |
文本 | 在其中合并 PR 的存储库的 URL。 如果配置了 PR Git 触发器 (通常如此),那么将从 PR 触发器填充此参数。 | 必需 |
base-repo-name |
文本 | 在其中合并 PR 的存储库的名称。 如果配置了 PR Git 触发器 (通常如此),那么将从 PR 触发器填充此参数。 | 必需 |
base-repo-owner |
文本 | 在其中合并 PR 的存储库的所有者。 如果配置了 PR Git 触发器 (通常如此),那么将从 PR 触发器填充此参数。 | 必需 |
baseimage-auth-email |
文本 | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的电子邮件凭证。 | 可选 |
baseimage-auth-host |
文本 | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的主机凭证。 | 可选 |
baseimage-auth-password |
Secret | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的密码凭证。 | 可选 |
baseimage-auth-user |
文本 | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的用户凭证。 | 可选 |
branch-protection-rules-path |
文本 | 设置 JSON 文件的路径,该文件包含所需合规性检查的定制列表 (相对于集成应用程序存储库)。 | 可选 |
branch-protection-status-check-prefix |
文本 | 分支保护状态检查的前缀文本 (缺省为 tekton ) |
可选 |
cocoa-config-retry-status-code |
文本 | 需要在可可 CLI 中重试的 API 调用的响应状态码。 例如:500,404 。 缺省值: 500 |
可选 |
cocoa-config-max-retry-attempts |
文本 | 可可 CLI 可以重试 API 调用的次数。 例如:5 。 缺省值: 3 |
可选 |
cocoa-config-git-default-branch (supported in Q4, 2022) |
文本 | 可可 CLI 的缺省 Git 分支。 例如:main 。 缺省值: master |
可选 |
collect-evidence-in-pr |
文本 | 设置此标记可根据所选选项在 PR 管道中收集证据。 选项:none , all , success |
可选 |
cos-api-key |
Secret | Cloud Object Storage API 密钥。 | 可选 |
cos-access-key-id |
Secret | 来自 HMAC 凭证的 Cloud Object Storage 访问密钥标识。 (与 cos-secret-access-key 一起提供,而不是与 cos-api-key 一起提供) |
可选 |
cos-secret-access-key |
Secret | 来自 HMAC 凭证的 Cloud Object Storage 私钥访问密钥。 (与 cos-access-key-id 一起提供,而不是与 cos-api-key 一起提供) |
可选 |
cos-bucket-name |
文本 | Cloud Object Storage 实例中用作证据锁定程序的存储区的名称。 | 可选 |
cos-endpoint |
文本 | 用于在用作证据锁定程序的 Cloud Object Storage 实例中存储证据的端点。 有关更多信息,请参阅 端点类型。 | 可选 |
cra-custom-script-path |
文本 | 要在 CRA 扫描之前运行的定制脚本的路径。 此脚本的来源是提供用于在 CRA BOM 工具的上下文中设置 ENV 变量的选项。 | 可选 |
cra-cveignore-path |
文本 | cveignore 的文件路径 (相对于应用程序存储库根目录)。 如果未提供值,那么缺省文件路径为 .cra/.cveignore 。 |
可选 |
cra-docker-build-context |
文本 | 如果指定了此标志,那么 Code Risk Analyzer 将路径参数中的目录用作 Docker 构建上下文。 缺省值为 false 。 |
可选 |
cra-docker-buildflags |
文本 | 定制用于构建阶段扫描的 Docker 构建命令。 该参数默认为空。 | 可选 |
cra-dockerfile-pattern |
文本 | 能够添加具有不同命名约定的 Dockerfile,例如 enterprise-linux.Dockerfile |
可选 |
cra-exclude-devdependencies |
文本 | 指定是否从扫描中排除开发依赖关系 (true 或 false )。 缺省值为 false 。 |
可选 |
cra-gradle-exclude-configs |
文本 | 指定要在扫描中排除依赖关系的 Gradle 配置。 示例: runtimeClasspath,testCompileClasspath 。 该参数默认为空。 |
可选 |
cra-maven-exclude-scopes |
文本 | 指定要在扫描中排除依赖关系的 Maven 作用域。 示例: test,compile 。 该参数默认为空。 |
可选 |
cra-nodejs-create-package-lock |
文本 | 启用 Code Risk Analyzer 发现以构建 node.js 存储库的 package-lock.json 文件。 缺省情况下,此参数设置为 false。 |
可选 |
cra-python-create-requirements-txt |
文本 | 不推荐使用。 新的 CRA 工具不再使用此参数。 启用 Code Risk Analyzer 发现以构建 Python 存储库的 requirements.txt 文件。 缺省情况下,此参数设置为 false。 |
可选 |
detect-secrets-baseline-filename |
文本 | 应用程序存储库中基线文件的名称。 | 可选 |
detect-secrets-exclusion-list |
文本 | 要在 detect-secret 扫描中排除的文件的正则表达式列表。 | 可选 |
detect-secrets-image |
文本 | 指定备用 detect-secret 图像,包括定制图像或特定版本的官方图像。 | 可选 |
detect-secrets-verbose |
文本 | 输出当前正在扫描的文件的名称。 | 可选 |
dind-image |
文本 | 用于运行侧柜的基本映像。 | 可选 |
evidence-repo |
工具集成 | 证据存储库 URL。 | 可选 |
evidence-reuse |
文本 | 将此标记设置为 1 以启用证据的重复使用。 |
可选 |
evidence-validity-period |
文本 | 可重复使用证据的有效期(小时)。 默认值:24 小时。 最大值:720 小时(30 天) | 可选 |
git-token |
Secret | Git 存储库访问令牌。 | 可选 |
github-token |
Secret | GitHub 存储库访问令牌。 | 可选 |
grit-token |
Secret | Git Repos and Issue Tracking 访问令牌。 | 可选 |
head-branch |
文本 | 在其中引发 PR 的源分支。 如果配置了 PR Git 触发器 (通常如此),那么将从 PR 触发器填充此参数。 | 必需 |
head-repo |
文本 | 在其中生成 PR 的存储库的 URL。 如果配置了 PR Git 触发器 (通常如此),那么将从 PR 触发器填充此参数。 | 必需 |
head-sha |
文本 | head-branch 上的 HEAD 落实。 如果配置了 PR Git 触发器 (通常如此),那么将从 PR 触发器填充此参数。 |
必需 |
iam_retry_count |
文本 | 等待访存 IAM 令牌的重试次数。 | 可选 |
iam_retry_sleep |
文本 | 访存 IAM 令牌的等待时间量。 | 可选 |
ibmcloud-api-key |
Secret | 与 ibmcloud CLI 工具交互的 IBM Cloud® API 密钥。 |
必需 |
incident-repo |
工具集成 | 事件会发出存储库 URL。 | 可选 |
one-pipeline-dockerconfigjson |
Secret | 用于从专用注册表拉取映像的 base64-encoded Docker config.json 文件。 |
可选 |
pipeline-config |
文本 | 定制管道行为的配置文件。 | 可选 |
pipeline-config-branch |
文本 | 的分支DevSecOps管道配置。 | 可选 |
pipeline-config-repo |
文本 | 的 repo URLDevSecOps管道配置位置。 | 可选 |
pipeline-dockerconfigjson |
Secret | 用于从专用注册表拉取映像的 base64-encoded Docker config.json 文件。 |
可选 |
pipeline-debug |
select | 管道调试方式开关。 | 可选 |
slack-notifications |
文本 | 打开或关闭 Slack 集成的交换机。 | 可选 |
[slack-notifications] (#pipeline-parm-slack-notifications) |
文本 | 打开或关闭 Slack 集成的交换机 | 可选 |
名称 | Type | 描述 | 必需或可选 |
---|---|---|---|
app-name |
文本 | 在工具链设置中指定的应用程序的名称。 | 必需 |
artifactory-dockerconfigjson |
Secret | base64-encoded Docker config.json 文件,用于存储 artifactory 的凭证信息。 |
可选 |
baseimage-auth-email |
文本 | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的凭证。 | 可选 |
baseimage-auth-host |
文本 | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的凭证。 | 可选 |
baseimage-auth-password |
Secret | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的凭证。 | 可选 |
baseimage-auth-user |
文本 | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的用户凭证。 | 可选 |
batched-evidence-collection |
文本 | 设置此标志以在批处理方式下启用证据收集,这将使网络调用最小化。 缺省 1 |
可选 |
branch |
文本 | 包含应用程序源代码的存储库的 Git 存储库分支。 缺省值:master |
可选 |
branch-protection-rules-path |
文本 | 设置 JSON 文件的路径,该文件包含所需合规性检查的定制列表 (相对于集成应用程序存储库)。 | 可选 |
branch-protection-status-check-prefix |
文本 | 分支保护状态检查的前缀文本 (缺省为 tekton ) |
可选 |
ciso-ibmcloud-api-key |
Secret | 覆盖 ibmcloud-api-key 以进行映像签名和签名验证。 |
可选 |
cocoa-config-retry-status-code |
文本 | 需要在可可 CLI 中重试的 API 调用的响应状态码。 例如:500,404 。 缺省值: 500 |
可选 |
cocoa-config-max-retry-attempts |
文本 | 可可 CLI 可以重试 API 调用的次数。 例如:5 。 缺省值: 3 |
可选 |
cocoa-config-git-default-branch (supported in Q4, 2022) |
文本 | 可可 CLI 的缺省 Git 分支。 例如:main 。 缺省值: master |
可选 |
cluster-name |
文本 | Docker 构建集群的名称。 | 必需 |
compliance-baseimage |
文本 | 用于运行内置管道代码的基本映像。 | 可选 |
cos-api-key |
Secret | Cloud Object Storage API 密钥。 | 可选 |
cos-access-key-id |
Secret | 来自 HMAC 凭证的 Cloud Object Storage 访问密钥标识。 (与 cos-secret-access-key 一起提供,而不是与 cos-api-key 一起提供) |
可选 |
cos-secret-access-key |
Secret | 来自 HMAC 凭证的 Cloud Object Storage 私钥访问密钥。 (与 cos-access-key-id 一起提供,而不是与 cos-api-key 一起提供) |
可选 |
cos-bucket-name |
文本 | Cloud Object Storage 实例中用作证据锁定程序的存储区的名称。 | 可选 |
cos-endpoint |
文本 | 用于在用作证据锁定程序的 Cloud Object Storage 实例中存储证据的端点。 有关更多信息,请参阅 端点类型。 | 可选 |
cr-ibmcloud-api-key |
Secret | 覆盖 ibmcloud-api-key (如果提供),用于从 Container Registry 拉取映像以进行 Sysdig 扫描。 |
可选 |
cr-resource-group |
文本 | 用于访问 Container Registry的资源组。 | 可选 |
cra-custom-script-path |
文本 | 要在 CRA 扫描之前运行的定制脚本的路径。 此脚本的来源是提供用于在 CRA BOM 工具的上下文中设置 ENV 变量的选项。 | 可选 |
cra-cveignore-path |
文本 | cveignore 的文件路径 (相对于应用程序存储库根目录)。 如果未提供值,那么缺省文件路径为 .cra/.cveignore 。 |
可选 |
cra-docker-build-context |
文本 | 如果指定了此标志,那么 Code Risk Analyzer 将路径参数中的目录用作 Docker 构建上下文。 缺省值为 false 。 |
可选 |
cra-docker-buildflags |
文本 | 定制用于构建阶段扫描的 Docker 构建命令。 该参数默认为空。 | 可选 |
cra-dockerfile-pattern |
文本 | 能够添加具有不同命名约定的 Dockerfile,例如 enterprise-linux.Dockerfile |
可选 |
cra-exclude-devdependencies |
文本 | 指定是否从扫描中排除开发依赖关系 (true 或 false )。 缺省值为 false 。 |
可选 |
cra-gradle-exclude-configs |
文本 | 指定要在扫描中排除依赖关系的 Gradle 配置。 示例: runtimeClasspath,testCompileClasspath 。 该参数默认为空。 |
可选 |
cra-ibmcloud-api-key |
Secret | 覆盖 CRA 任务所使用的 ibmcloud-api-key 。 |
可选 |
cra-maven-exclude-scopes |
文本 | 指定要在扫描中排除依赖关系的 Maven 作用域。 示例: test,compile 。 该参数默认为空。 |
可选 |
cra-nodejs-create-package-lock |
文本 | 启用 Code Risk Analyzer 发现以构建 node.js 存储库的 package-lock.json 文件。 缺省情况下,此参数设置为 false。 |
可选 |
cra-python-create-requirements-txt |
文本 | 不推荐使用。 新的 CRA 工具不再使用此参数。 启用 Code Risk Analyzer 发现以构建 Python 存储库的 requirements.txt 文件。 缺省情况下,此参数设置为 false。 |
可选 |
custom-exempt-label |
文本 | 定义将突发事件问题标记为“已免除”的定制标签。 | 可选 |
custom-image-tag |
文本 | 以逗号分隔的列表中图像的定制标记。 | 可选 |
detect-secrets-baseline-filename |
文本 | 应用程序存储库中基线文件的名称。 | 可选 |
detect-secrets-exclusion-list |
文本 | 要在 detect-secret 扫描中排除的文件的正则表达式列表。 | 可选 |
detect-secrets-image |
文本 | 指定备用 detect-secret 图像,包括定制图像或特定版本的官方图像。 | 可选 |
detect-secrets-verbose |
文本 | 输出当前正在扫描的文件的名称。 | 可选 |
dev-cluster-namespace |
文本 | 托管和部署 Docker 引擎的 Kubernetes 集群名称空间。 | 必需 |
dev-region |
文本 | 托管集群的 IBM Cloud 区域。 | 必需 |
dev-resource-group |
文本 | 集群资源组。 | 必需 |
doi-buildnumber |
文本 | 要在 ibmcloud doi 命令中用作 --buildnumber 标志的构建号值。 |
可选 |
doi-environment |
文本 | DevOps Insights 目标环境。 | 可选 |
doi-ibmcloud-api-key |
Secret | IBM Cloud API 密钥,用于与上载 DOI 记录的 DevOps Insights 实例进行交互。 | 可选 |
doi-logicalappname |
文本 | 要在 ibmcloud doi 命令中用作 --logicalappname 标志的应用程序名称 |
可选 |
doi-tags |
文本 | 以逗号分隔的定制标记。 | 可选 |
doi-toolchain-id |
文本 | DevOps Insights 实例工具链标识。 | 可选 |
evidence-repo |
工具集成 | 证据存储库 URL。 | 可选 |
evidence-reuse |
文本 | 将此标记设置为 1 以启用证据的重复使用。 |
可选 |
evidence-validity-period |
文本 | 可重复使用证据的有效期(小时)。 默认值:24 小时。 最大值:720 小时(30 天) | 可选 |
git-token |
Secret | Git 存储库访问令牌。 | 可选 |
github-token |
Secret | GitHub 存储库访问令牌。 | 可选 |
gosec-additional-flags |
文本 | 要附加到 gosec 命令开头的额外标志。 |
可选 |
gosec-private-repository-url |
文本 | (不推荐) 专用存储库基本 URL。 例如,https://github.ibm.com 。 |
可选 |
gosec-private-repository-host |
文本 | 您的专用存储库主机。 例如, github.ibm.com |
可选 |
gosec-private-repository-ssh-key |
私钥 | 专用存储库的 SSH 密钥。 | 可选 |
gosec-private-repository-user |
文本 | 具有 https 访问权的专用存储库的用户 (缺省为 x-oauth-basic ) |
可选 |
gosec-private-repository-token |
私钥 | 用于对专用存储库进行 https 访问的令牌 (缺省为在 gosec-private-repository-host 的值上托管存储库 URL 的工具链中为第一个 Git 集成配置的令牌) |
可选 |
gosec-proxy-virtual-repository-token |
私钥 | gosec 代理的虚拟存储库令牌。 |
可选 |
gosec-proxy-virtual-repository-user |
文本 | gosec 代理的虚拟存储库用户。 |
可选 |
gosec-proxy-virtual-repository-url |
文本 | gosec 代理的虚拟存储库 URL。 |
可选 |
gosec-scan-image |
文本 | 指定备用 gosec 映像,包括定制映像或特定版本的官方映像。 |
可选 |
grit-token |
Secret | Git Repos and Issue Tracking 访问令牌。 | 可选 |
iam_retry_count |
文本 | 等待访存 IAM 令牌的重试次数。 | 可选 |
iam_retry_sleep |
文本 | 访存 IAM 令牌的等待时间量。 | 可选 |
ibmcloud-api-key |
Secret | 与 ibmcloud CLI 工具交互的 IBM Cloud API 密钥。 |
必需 |
ibmcloud-enable-session-keep-alive |
select | 如果此值设置为 1,那么对于 Code Risk Analyzer 扫描中长时间运行的作业,请使 IBM Cloud CLI 会话保持活动状态。 | 可选 |
icr-dockerconfigjson |
Secret | base64-encoded Docker config.json 文件,用于存储 IBM Container Registry的凭证信息。 此参数由 SLSA 认证使用。 |
可选 |
incident-assignee |
文本 | 事件问题的受让人 (GitHub 或 GitLab 用户名)。 | 可选 |
incident-assignees |
文本 | 事件问题的受让人 (一个或多个以逗号分隔的用户名)。 此参数只能与 GitHub 和 GitLab Premium 帐户配合使用。 | 可选 |
incident-label |
文本 | 新突发事件问题的标签。 | 可选 |
incident-labels |
文本 | 新事件问题的标签。incident-labels 可以是一个或多个以逗号分隔的标签。 |
可选 |
incident-repo |
工具集成 | 事件会发出存储库 URL。 | 可选 |
inventory-repo |
工具集成 | 库存存储库 URL。 | 可选 |
dind-image |
文本 | 用于运行侧柜的基本映像。 | 可选 |
opt-in-gosec |
文本 | 启用 gosec 静态扫描。 |
可选 |
one-pipeline-dockerconfigjson |
Secret | 用于从专用注册表拉取映像的 base64-encoded Docker config.json 文件。 |
可选 |
opt-in-dynamic-api-scan |
文本 | 启用 OWASP Zap API 扫描。 | 可选 |
opt-in-dynamic-scan |
文本 | 启用 OWASP Zap 扫描。 | 可选 |
opt-in-dynamic-ui-scan |
文本 | 启用 OWASP Zap UI 扫描。 | 可选 |
opt-in-pr-collection |
文本 | 添加任何值以启用 PR 收集。 | 可选 |
opt-in-sonar |
文本 | Sonarqub 扫描集成。 | 可选 |
opt-in-sonar-hotspots |
文本 | 允许在 Sonarqube 扫描中进行热点检测。 | 可选 |
opt-out-ci-set-commit-status |
文本 | 如果此参数具有任何值,那么 CI 管道不会根据 CI 管道执行的结果 (成功或失败) 来设置源代码存储库的落实状态值。 | 可选 |
opt-out-nonvulnerability-issue-collection |
文本 | 添加任何值以选择退出与非漏洞相关的问题集合。 | 可选 |
peer-review-compliance |
文本 | 在 CI 和 CD 管道中将 peer-review-compliance 环境变量设置为 1,以激活同行评审检查。 同样,在 CD 管道中,此配置将对链接到当前部署的所有拉取请求运行同级复审验证。 |
可选 |
peer-review-collection |
文本 | 要检索正在进行的部署的拉取请求及其关联标题的列表,请将此值设置为 1 | 可选 |
pipeline-config |
文本 | 定制管道行为的配置文件。 | 必需 |
pipeline-config-branch |
文本 | 的分支DevSecOps管道配置。 | 可选 |
pipeline-config-repo |
文本 | 的 repo URLDevSecOps管道配置位置。 | 可选 |
publish-retry-duration |
文本 | 指定在启动下一次发布证据尝试之前要等待的持续时间 (以秒计)。 | 可选 |
pipeline-debug |
select | 管道调试方式开关。 | 可选 |
registry-namespace |
文本 | 映像的 Container Registry 名称空间。 | 必需 |
registry-region |
文本 | 映像注册表的 IBM Cloud 区域。 | 必需 |
repository |
文本 | 应用程序的源代码存储库的 URL。 | 可选 |
repository-integration |
文本 | 存储库的集成名称。 | 可选 |
sbom-validation-collect-evidence |
文本 | 针对 cyclonedx sbom 启用 sbom 验证扫描的证据收集。 如果此值设置为 1,那么 sbom 验证将收集证据。 | 可选 |
signing-key |
Secret | 用于使用 .pfx 文件数据对映像进行签名的 base64-encoded 专用密钥。 |
必需 |
skip-inventory-update-on-failure |
文本 | 在发生故障的 CI 运行时停止库存更新的交换机。 | 可选 |
slack-notifications |
文本 | 打开或关闭 Slack 集成的交换机 | 可选 |
slsa-attestation |
select | 启用 SLSA 认证的交换机。 | 可选 |
slsa-attestation-public-key |
Secret | 用于验证 SLSA 认证报告的 base64-encoded 公用密钥。 | 可选 |
sonarqube |
工具集成 | Sonarqube 工具集成。 | 可选 |
sonarqube_standby |
工具集成 | 可用作回退的备用 Sonarqube 工具集成。 | 可选 |
sonarqube-config |
文本 | 在隔离的 Docker-Docker 容器 (缺省配置) 或现有开发 Kubernetes 集群 (集群配置) 中运行 SonarQube 扫描。 或者,您可以自带 SonarQube 实例并配置 SonarQube 工具集成 (定制配置)。 选项: default ,cluster 或 custom 。 默认为 default 。 有关更多信息,请参阅 (将 SonarQube 添加到持续集成管道)。 |
必需 |
sonarqube-namespace |
文本 | 要与管道创建的 SonarQube 实例配合使用的已配置 Kubernetes 名称空间。 | 可选 |
sonarqube-instance-image |
文本 | 用于作为隔离的 Docker-Docker 容器运行的 sonarqub 实例映像。 | 可选 |
sonarqube-scanner-image |
文本 | 用于缺省 sonarqub 扫描命令的 sonarqub 扫描程序 CLI 图像。 | 可选 |
sonarqube-scan-command |
文本 | 启动 sonarqub 扫描的 sonarqub 扫描命令。必须为 Maven Java 项目设置 sonarqube-scan-command 。 有关更多信息,请参阅 sonarqube-scan-command |
可选 |
static-scan-retry-count |
文本 | 等待建立 Sonarqube 实例的重试次数。 | 可选 |
static-scan-retry-sleep |
文本 | 每次重试迭代的等待时间量。 | 可选 |
subpipeline-webhook-token |
Secret | Subpipeline Webhook Trigger for 触发异步管道 的 Webhook 私钥。 另请参阅 更新 async 阶段 Webhook。 |
可选 |
sysdig-api-token |
文本 | Sysdig API 令牌值。 该令牌可从 Sysdig 实例的“用户概要文件”页面中查看。 运行 Sysdig 扫描需要此值。 | 必需 |
sysdig-inline-scanner-image |
文本 | 要用于扫描的 sysdig 内联扫描程序图像。 缺省值为 quay.io/sysdig/secure-inline-scan:2 |
可选 |
sysdig-scan |
select | 对图像启用 Sysdig 扫描。 如果此值设置为 1,那么将启用 Sysdig 扫描。 | 必需 |
sysdig-policies |
文本 | 具有逗号分隔值的 sysdig 策略的标识。 您可以在 How to scan Images with this policy 部分下找到策略标识 (在 --policy 标记后查找名称) |
可选 |
sysdig-url |
文本 | 要用于扫描的 Sysdig 实例的 URL。 缺省值为 https://us-south.security-compliance-secure.cloud.ibm.com |
可选 |
va-scan-retry-count |
文本 | 等待漏洞报告扫描的重试次数。 | 必需 |
va-scan-retry-sleep |
文本 | 每次重试迭代的等待次数。 | 可选 |
version |
文本 | 要部署的应用程序版本。 | 必需 |
名称 | Type | 描述 | 必需或可选 |
---|---|---|---|
artifact-token |
Secret | 存储工件的令牌 | 如果工件存储库位于其他源提供程序中,那么此参数是必需的。 |
artifactory-dockerconfigjson |
Secret | base64-encoded Docker config.json 文件,用于存储 artifactory 的凭证信息。 |
可选 |
assignee |
文本 | 变更请求的受让人。 | 可选 |
backout-plan |
文本 | 计划在发生故障时如何回滚更改。 | 可选 |
batched-evidence-collection |
文本 | 设置此标志以在批处理方式下启用证据收集,这将使网络调用最小化。 缺省 1 |
可选 |
ciso-ibmcloud-api-key |
Secret | 覆盖 ibmcloud-api-key 以进行映像签名和签名验证。 |
可选 |
cocoa-config-retry-status-code |
文本 | 需要在可可 CLI 中重试的 API 调用的响应状态码。 例如:500,404 。 缺省值: 500 |
可选 |
cocoa-config-max-retry-attempts |
文本 | 可可 CLI 可以重试 API 调用的次数。 例如:5 。 缺省值: 3 |
可选 |
cocoa-config-git-default-branch (supported in Q4, 2022) |
文本 | 可可 CLI 的缺省 Git 分支。 例如:main 。 缺省值: master |
可选 |
change-request-duration |
文本 | 变更的计划结束时间。 | 可选 |
change-management-repo |
文本 | 变更管理存储库的 URL。 | 可选 |
change-request-id |
文本 | 打开的变更请求的标识。 如果缺省情况下此参数设置为 notAvailable ,那么连续部署管道将自动创建变更请求。 |
可选 |
cluster |
文本 | Docker 构建集群的名称。 | 必需 |
cluster-region |
文本 | 托管集群的 IBM Cloud 区域。 | 必需 |
compliance-baseimage |
文本 | 用于运行内置管道代码的基本映像。 | 可选 |
cos-api-key |
Secret | Cloud Object Storage API 密钥。 | 可选 |
cos-access-key-id |
Secret | 来自 HMAC 凭证的 Cloud Object Storage 访问密钥标识。 (与 cos-secret-access-key 一起提供,而不是与 cos-api-key 一起提供) |
可选 |
cos-secret-access-key |
Secret | 来自 HMAC 凭证的 Cloud Object Storage 私钥访问密钥。 (与 cos-access-key-id 一起提供,而不是与 cos-api-key 一起提供) |
可选 |
cos-bucket-name |
文本 | Cloud Object Storage 实例中用作证据锁定程序的存储区的名称。 | 可选 |
cos-endpoint |
文本 | 用于在用作证据锁定程序的 Cloud Object Storage 实例中存储证据的端点。 有关更多信息,请参阅 端点类型。 | 可选 |
cr-pipeline-name |
文本 | 正在创建变更请求的管道的名称。 | 可选 |
cr-pipeline-version |
文本 | 正在创建变更请求的管道的版本。 | 可选 |
cra-ibmcloud-api-key |
Secret | 覆盖 CRA 任务所使用的 ibmcloud-api-key 。 |
可选 |
customer-impact |
文本 | 变更对客户的影响。 | 可选 |
deployment-impact |
文本 | 更改对部署的影响。 | 可选 |
description |
文本 | 附加到“变更请求描述”的变更的描述。 | 可选 |
dind-image |
文本 | 用于运行侧柜的基本映像。 | 可选 |
doi-buildnumber |
文本 | 要在 ibmcloud doi 命令中用作 --buildnumber 标志的构建号值。 |
可选 |
doi-environment |
文本 | DevOps Insights 目标环境。 | 可选 |
doi-ibmcloud-api-key |
Secret | IBM Cloud API 密钥,用于与上载 DOI 记录的 DevOps Insights 实例进行交互。 | 可选 |
doi-logicalappname |
文本 | 要在 ibmcloud doi 命令中用作 --logicalappname 标志的应用程序名称 |
可选 |
doi-tags |
文本 | 以逗号分隔的定制标记。 | 可选 |
doi-toolchain-id |
文本 | DevOps Insights 实例工具链标识。 | 可选 |
emergency-label |
文本 | 将拉取请求标识为紧急情况。 | 可选 |
evidence-repo |
工具集成 | 证据存储库 URL。 | 可选 |
force-redeploy |
文本 | 强制部署或重新部署应用程序,即使上次部署未在库存中包含增量也是如此。 将此参数设置为 true 以强制部署应用程序,就好像它是指定目标环境上的第一个部署一样。 默认情况下,该参数设置为 false 。 |
可选 |
git-token |
Secret | Git 存储库访问令牌。 | 可选 |
github-token |
Secret | GitHub 存储库访问令牌。 | 可选 |
grit-token |
Secret | Git Repos and Issue Tracking 访问令牌。 | 可选 |
iam_retry_count |
文本 | 等待访存 IAM 令牌的重试次数。 | 可选 |
iam_retry_sleep |
文本 | 访存 IAM 令牌的等待时间量。 | 可选 |
ibmcloud-api-key |
Secret | 与 ibmcloud CLI 工具交互的 IBM Cloud API 密钥。 |
必需 |
impact |
文本 | 有关此变更实施影响的额外说明。 | 可选 |
incident-repo |
工具集成 | 事件会发出存储库 URL。 | 可选 |
inventory-repo |
工具集成 | 库存存储库 URL。 | 可选 |
incident-assignee |
文本 | 事件问题的受让人 (GitHub 或 GitLab 用户名)。 | 可选 |
incident-assignees |
文本 | 事件问题的一个或多个受托人 (一个或多个以逗号分隔的用户名)。 此参数只能与 GitHub 和 GitLab Premium 帐户配合使用。 | 可选 |
incident-label |
文本 | 新突发事件问题的标签。 | 可选 |
incident-labels |
文本 | 新事件问题的标签。incident-labels 可以是一个或多个以逗号分隔的标签。 |
可选 |
opt-in-pr-collection |
文本 | 添加任何值以启用 PR 收集。 | 可选 |
opt-out-nonvulnerability-issue-collection |
文本 | 添加任何值以选择退出与非漏洞相关的问题集合。 | 可选 |
pipeline-config |
文本 | 定制管道行为的配置文件。 | 必需 |
pipeline-config-branch |
文本 | 的分支DevSecOps管道配置。 | 可选 |
pipeline-config-repo |
文本 | 的 repo URLDevSecOps管道配置位置。 | 可选 |
pipeline-debug |
select | 管道调试方式开关。 | 可选 |
pipeline-dockerconfigjson |
Secret | 用于从专用注册表拉取映像的 base64-encoded Docker config.json 文件。 |
可选 |
pre-prod-evidence-collection |
文本 | 设置此标志以收集生产前证据和生产部署中的变更请求 (target-environment-purpose 设置为 production )。 默认值为 0 。 |
可选 |
priority |
文本 | 变更请求的优先级。 | 可选 |
publish-retry-duration |
文本 | 指定在启动下一次发布证据尝试之前要等待的持续时间 (以秒计)。 | 可选 |
purpose |
文本 | 需要更改的原因。 | 可选 |
region |
文本 | 部署应用程序的目标区域。 | 可选 |
rollback-enabled |
文本 | 用于设置是否启用内联回滚功能的标志。 缺省值 "0" | 可选 |
sbom-validation-collect-evidence |
文本 | 在 CI 管道中启用验证 sbom 验证扫描的状态。 如果此值设置为 1,那么将验证 sbom 验证 (成功或失败) 扫描的状态为 CI。 | 可选 |
source-environment |
文本 | 从中提升应用程序的源环境。 | 必需 |
summary-retry-attempts |
文本 | 设置证据摘要上载的最大重试次数。 默认值为 5 。 |
可选 |
summary-max-retry-time |
文本 | 设置证据摘要上载的最大回退时间。 每次重试都会成倍生成实际的回退时间,直到达到使用此参数设置的最大回退时间为止。 默认值为 32 。 |
可选 |
target-environment |
文本 | 部署应用程序的目标环境。 | 必需 |
target-environment-purpose |
文本 | 部署应用程序的环境的上下文。 有效值: pre_prod 和 production |
必需 |
target-environment-detail |
文本 | 部署应用程序的目标环境的描述。 | 必需 |
version |
文本 | 要部署的应用程序版本。 | 必需 |
名称 | Type | 描述 | 必需或可选 |
---|---|---|---|
app-url |
文本 | 部署在目标上的应用程序的 URL。 建议用于使用登台应用程序 URL 的应用程序。 | 必需 |
artifactory-dockerconfigjson |
Secret | base64-encoded Docker config.json 文件,用于存储 artifactory 的凭证信息。 |
可选 |
baseimage-auth-email |
文本 | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的凭证。 | 可选 |
baseimage-auth-host |
文本 | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的凭证。 | 可选 |
baseimage-auth-password |
Secret | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的凭证。 | 可选 |
baseimage-auth-user |
文本 | 代码风险分析器扫描所需的应用程序 Dockerfile 基本映像的用户凭证。 | 可选 |
batched-evidence-collection |
文本 | 设置此标志以在批处理方式下启用证据收集,这将使网络调用最小化。 缺省 1 |
可选 |
branch |
文本 | 包含应用程序源代码的存储库的 Git 存储库分支。 缺省值: master 。 |
可选 |
cocoa-config-retry-status-code |
文本 | 需要在可可 CLI 中重试的 API 调用的响应状态码。 例如:500,404 。 缺省值: 500 |
可选 |
cocoa-config-max-retry-attempts |
文本 | 可可 CLI 可以重试 API 调用的次数。 例如:5 。 缺省值: 3 |
可选 |
cocoa-config-git-default-branch (supported in Q4, 2022) |
文本 | 可可 CLI 的缺省 Git 分支。 例如:main 。 缺省值: master |
可选 |
cocoa-display-elapsed-time |
文本 | 将此参数设置为非空值以打印可可 CLI 命令执行的耗用时间 (以秒计)。 示例: Elapsed time: 5.32 seconds 。 |
可选 |
compliance-baseimage |
文本 | 用于运行内置管道代码的基本映像。 | 可选 |
cos-api-key |
Secret | Cloud Object Storage API 密钥。 | 可选 |
cos-access-key-id |
Secret | 来自 HMAC 凭证的 Cloud Object Storage 访问密钥标识。 (与 cos-secret-access-key 一起提供,而不是与 cos-api-key 一起提供) |
可选 |
cos-secret-access-key |
Secret | 来自 HMAC 凭证的 Cloud Object Storage 私钥访问密钥。 (与 cos-access-key-id 一起提供,而不是与 cos-api-key 一起提供) |
可选 |
cos-bucket-name |
文本 | Cloud Object Storage 实例中用作证据锁定程序的存储区的名称。 | 可选 |
cos-endpoint |
文本 | 用于在用作证据锁定程序的 Cloud Object Storage 实例中存储证据的端点。 有关更多信息,请参阅 端点类型。 | 可选 |
cr-ibmcloud-api-key |
Secret | 覆盖 ibmcloud-api-key (如果提供),用于从 Container Registry 拉取映像以进行 Sysdig 扫描。 |
可选 |
cr-resource-group |
文本 | 用于访问 Container Registry的资源组。 | 可选 |
cra-custom-script-path |
文本 | 要在 CRA 扫描之前运行的定制脚本的路径。 此脚本的来源是提供用于在 CRA BOM 工具的上下文中设置 ENV 变量的选项。 | 可选 |
cra-cveignore-path |
文本 | cveignore 的文件路径 (相对于应用程序存储库根目录)。 如果未提供值,那么缺省文件路径为 .cra/.cveignore 。 |
可选 |
cra-docker-build-context |
文本 | 如果指定了此标志,那么 Code Risk Analyzer 将路径参数中的目录用作 Docker 构建上下文。 缺省值为 false 。 |
可选 |
cra-docker-buildflags |
文本 | 定制用于构建阶段扫描的 Docker 构建命令。 该参数默认为空。 | 可选 |
cra-dockerfile-pattern |
文本 | 能够添加具有不同命名约定的 Dockerfile,例如 enterprise-linux.Dockerfile |
可选 |
cra-exclude-devdependencies |
文本 | 指定是否从扫描中排除开发依赖关系 (true 或 false )。 缺省值为 false 。 |
可选 |
cra-gradle-exclude-configs |
文本 | 指定要在扫描中排除依赖关系的 Gradle 配置。 示例: runtimeClasspath,testCompileClasspath 。 该参数默认为空。 |
可选 |
cra-generate-cyclonedx-format |
文本 | 如果设置为 1 ,那么 CRA 还会生成 cyclonedx 格式的 BOM (缺省为 0 )。 |
可选 |
cra-ibmcloud-api-key |
Secret | 覆盖 CRA 任务所使用的 ibmcloud-api-key 。 |
可选 |
cra-maven-exclude-scopes |
文本 | 指定要在扫描中排除依赖关系的 Maven 作用域。 示例: test,compile 。 该参数默认为空。 |
可选 |
cra-nodejs-create-package-lock |
文本 | 启用 Code Risk Analyzer 发现以构建 node.js 存储库的 package-lock.json 文件。 缺省情况下,此参数设置为 false。 |
可选 |
cra-python-create-requirements-txt |
文本 | 不推荐使用。 新的 CRA 工具不再使用此参数。 启用 Code Risk Analyzer 发现以构建 Python 存储库的 requirements.txt 文件。 缺省情况下,此参数设置为 false。 |
可选 |
custom-exempt-label |
文本 | 定义将突发事件问题标记为免除的定制标签。 | 可选 |
detect-secrets-baseline-filename |
文本 | 应用程序存储库中基线文件的名称。 | 可选 |
detect-secrets-exclusion-list |
文本 | 要在 detect-secret 扫描中排除的文件的正则表达式列表。 | 可选 |
detect-secrets-image |
文本 | 指定备用 detect-secret 图像,包括定制图像或特定版本的官方图像。 | 可选 |
detect-secrets-verbose |
文本 | 输出当前正在扫描的文件的名称。 | 可选 |
dev-region |
文本 | 托管集群的 IBM Cloud 区域。 对于缺省静态和动态扫描是必需的。 | 必需 |
dev-resource-group |
文本 | 集群资源组。 | 必需 |
dind-image |
文本 | 用于运行侧柜的基本映像。 | 可选 |
doi-environment |
文本 | DevOps Insights 目标环境。 | 可选 |
doi-ibmcloud-api-key |
Secret | IBM Cloud API 密钥,用于与上载 DOI 记录的 DevOps Insights 实例进行交互。 | 可选 |
doi-tags |
文本 | 以逗号分隔的定制标记。 | 可选 |
doi-toolchain-id |
文本 | DevOps Insights 实例工具链标识。 | 可选 |
environment-tag |
文本 | 表示库存中目标环境的标记名称。 示例: prod_latest |
必需 |
evidence-repo |
工具集成 | 证据存储库 URL。 | 可选 |
git-token |
Secret | Git 存储库访问令牌。 | 可选 |
github-token |
Secret | GitHub 存储库访问令牌。 | 可选 |
grit-token |
Secret | Git Repos and Issue Tracking 访问令牌。 | 可选 |
ibmcloud-api-key |
Secret | 与 ibmcloud CLI 工具交互的 IBM Cloud API 密钥。 |
必需 |
ibmcloud-enable-session-keep-alive |
select | 如果此值设置为 1,那么对于 Code Risk Analyzer 扫描中长时间运行的作业,请使 IBM Cloud CLI 会话保持活动状态。 | 可选 |
incident-assignee |
文本 | 事件问题的受让人 (GitHub 或 GitLab 用户名)。 | 可选 |
incident-assignees |
文本 | 事件问题的一个或多个受托人 (一个或多个以逗号分隔的用户名)。 此参数只能与 GitHub 和 GitLab Premium 帐户配合使用。 | 可选 |
incident-label |
文本 | 新突发事件问题的标签。 | 可选 |
incident-labels |
文本 | 新事件问题的标签。incident-labels 可以是一个或多个以逗号分隔的标签。 |
可选 |
incident-repo |
工具集成 | 事件会发出存储库 URL。 | 可选 |
inventory-exclude |
文本 | 要在 CC 管道中扫描和测试而排除的库存条目的逗号分隔列表。 还可以使用 glob 模式指定条目。 | 可选 |
inventory-include |
文本 | 在 CC 管道中包含的用于扫描和测试的库存条目的逗号分隔列表。 还可以使用 glob 模式指定条目。 如果未设置,那么将扫描并测试所有条目。 | 可选 |
inventory-repo |
工具集成 | 库存存储库 URL。 | 可选 |
opt-in-auto-close |
文本 | 当 CC 管道运行不再检测到漏洞时,允许自动关闭来自漏洞的问题。 | 可选 |
opt-in-cra-auto-remediation |
文本 | 指定是运行 IBM Cloud cra auto remediation (true 还是 false )。 |
可选 |
opt-in-cra-auto-remediation-enabled-repos |
文本 | 指定要为 IBM Cloud cra auto remediation 打开的以逗号分隔的存储库名称的列表。 仅当 opt-in-cra-auto-remediation 设置为 true 时,才会考虑此参数 |
可选 |
opt-in-cra-auto-remediation-force |
文本 | 强制 IBM Cloud cra auto remediation 更新软件包,即使主版本与当前易受攻击的软件包版本 (true 或 false ) 不同也是如此。 仅当 opt-in-cra-auto-remediation 设置为 true 时,才会考虑此参数 |
可选 |
opt-in-dynamic-api-scan |
文本 | 启用 OWASP Zap API 扫描。 | 可选 |
opt-in-dynamic-scan |
文本 | 启用 OWASP Zap 扫描。 | 可选 |
opt-in-dynamic-ui-scan |
文本 | 启用 OWASP Zap UI 扫描。 | 可选 |
opt-in-sonar |
文本 | Sonarqube 扫描集成。 | 可选 |
opt-in-sonar-hotspots |
文本 | 允许在 sonarqub 扫描中进行热点检测。 | 可选 |
opt-out-nonvulnerability-issue-collection |
文本 | 添加任何值以选择退出与非漏洞相关的问题集合。 | 可选 |
pipeline-config |
文本 | 定制管道行为的配置文件。 | 必需 |
pipeline-config-branch |
文本 | 的分支DevSecOps管道配置。 | 可选 |
pipeline-config-repo |
文本 | 的 repo URLDevSecOps管道配置位置。 | 可选 |
pipeline-debug |
select | 管道调试方式开关。 | 可选 |
pipeline-dockerconfigjson |
Secret | 用于从专用注册表拉取映像的 base64-encoded Docker config.json 文件。 |
可选 |
publish-retry-duration |
文本 | 指定在启动下一次发布证据尝试之前要等待的持续时间 (以秒计)。 | 可选 |
region-prefix |
文本 | 区域名称作为目标环境的 latest 标记的前缀。 示例: us-south |
可选 |
repo-url |
文本 | 应用程序存储库的 URL。 | 必需 (如果使用同一库存来存储多个应用程序工件)。 |
repository-integration |
文本 | 存储库的集成名称。 | 可选 |
sbom-validation-collect-evidence |
文本 | 针对 cyclonedx sbom 启用 sbom 验证扫描的证据收集。 如果此值设置为 1,那么 sbom 验证将收集证据。 | 可选 |
slack-notifications |
文本 | 打开或关闭 Slack 集成的交换机 | 可选 |
sonarqube |
工具集成 | Sonarqube 工具集成。 | 可选 |
sonarqube-config |
文本 | 在隔离的 Docker-Docker 容器 (缺省配置) 或现有开发 Kubernetes 集群 (集群配置) 中运行 SonarQube 扫描。 或者,您可以自带 SonarQube 实例并配置 SonarQube 工具集成 (定制配置)。 选项: default ,cluster 或 custom 。 默认为 default 。 有关更多信息,请参阅 (将 SonarQube 添加到持续集成管道)。 |
必需 |
sysdig-api-token |
文本 | Sysdig API 令牌值。 该令牌可从 Sysdig 实例的“用户概要文件”页面中查看。 运行 Sysdig 扫描需要此值。 | 必需 |
sysdig-inline-scanner-image |
文本 | 要用于扫描的 sysdig 内联扫描程序图像。 缺省值为 quay.io/sysdig/secure-inline-scan:2 |
可选 |
sysdig-scan |
select | 对图像启用 Sysdig 扫描。 如果此值设置为 1,那么将启用 Sysdig 扫描。 | 必需 |
sysdig-url |
文本 | 要用于扫描的 Sysdig 实例的 URL。 缺省值为 https://secure.sysdig.com |
可选 |
名称 | Type | 描述 | 必需或可选 |
---|---|---|---|
dind-image |
文本 | 用于运行侧柜的基本映像。 | 可选 |
库存忽略文件 | 文本 | .inventoryignore 文件的自定义文件名,该文件包含每次部分促销运行时要忽略的文件/文件夹列表。 | 可选 |
库存包括 | 文本 | 在部分促销中选择性促销的库存条目。 | 可选 |
库存排除 | 文本 | 部分促销中要排除的库存条目。 | 可选 |
规格
以下规范可帮助说明参数。
受托人
此参数用于提升拉取请求。 此值用于保存变更请求的受让人。 它必须是将分配给变更管理系统中的变更请求的功能标识或电子邮件。
回退计划
此参数用于提升拉取请求。 计划在发生故障时如何回滚更改。 默认为空。
分支
这是 CI 管道的可选参数。 它确定哪个分支从应用程序存储库中提取代码。 默认情况下,它是 master
。
更改请求持续时间
这是 CD 管道的可选参数。 该值将更改维护持续时间。 缺省值为 30 min
。
更改请求标识
这是 CD 管道的可选参数。 通过提供变更请求标识,管道将跳过创建新的变更请求并使用提供的变更请求。 如果此参数设置为 notAvailable
或留空,那么连续部署管道将自动创建变更请求。 默认值为 notAvailable
。
集群
此参数用于保存 CD 管道中用于 Docker 部署的集群的名称。 示例应用程序需要此参数。
集群名称
此参数用于保存 CI 管道中用于 Docker 部署的集群的名称。 此参数是必需的。
集群区域
这是 CD 管道的参数。 托管集群的 IBM Cloud 区域。 这是示例应用程序的必需参数。
合规性-基本映像
此参数用于保存合规性基本映像的版本。 如果要使用除最新图像以外的其他内容,请使用此参数。
示例:
icr.io/continuous-delivery/toolchains/devsecops/baseimage:some-other-tag
定制免除标签
这是 CI 和 CC 管道的可选参数。 如果您标记了使用定制标签永久免除的突发事件问题,那么此参数必须保存定制标签的值。
客户影响
此参数用于提升拉取请求。 它记录变更请求对客户的影响。 缺省情况下,该参数是以管道分隔的字符串 'Critical | High | Moderate | Low | No_Impact'
。 编辑缺省字符串以选择其中一个选项。
部署影响
此参数用于提升拉取请求。 它记录变更请求对部署的影响。 缺省情况下,该参数是以管道分隔的字符串 'Small | Large'
。 编辑缺省字符串以选择其中一个选项。
描述
此参数用于提升拉取请求。 此参数包含随“变更请求描述”一起附加的变更描述。 默认为空。
detect-密钥-基线-文件名
此参数指定由 detect-secret 使用的基线文件的定制文件名。 缺省情况下,detect-secret 在存储库根目录中查找名为 .secrets.baseline
的文件。 但是,如果以不同方式命名基线文件,那么可以使用此参数来提供其文件名。
detect-secret-排除-list
此参数是在没有现有基线文件的情况下运行时覆盖缺省排除列表的环境属性。 此参数标识要忽略的文件,以便不会创建链接到这些文件的问题。
detect-secret-image
此参数可用于指定要使用的其他 detect-secret 映像,例如定制映像或官方 detect-secret 映像的特定版本。
detect-secret-verbose
此参数设置为 1 时,将记录正在扫描的当前文件的名称。
丁-映像
此参数用于设置定制 dind 映像。 设置此参数以使用定制 dind 图像标记
影响
此参数用于提升拉取请求。 有关此“变更实施”将影响的其他注释。 默认为空。
管道调试
如果此参数设置为 1,那么管道将以调试方式运行,并且日志将显示更多信息。 默认设置为 0。
优先级
此参数用于提升拉取请求。 变更请求的优先级。 缺省情况下为 'Critical | High | Moderate | Low | Plan'
。 您可以将其更改为下列其中一个值。
用途
此参数用于提升拉取请求。 需要更改的原因。 默认为空。
签名密钥
此参数用于 CI 管道。 这是一个私钥类型参数,用于保存用于使用 .pfx
文件数据对映像进行签名的 base64-encoded 专用密钥。
Slack-通知
切换以打开或关闭 Slack 集成。 缺省情况下,此选项处于关闭状态,因此值为 0
。 设置为 1
以将其打开,设置为 0
以将其关闭。
sonarqube
此参数适用于使用静态扫描阶段的所有管道。 这是集成类型参数。 如果您正在使用自己的 sonarque 集成,请选择该集成作为值。 默认情况下,该参数为空。
sonarqube-namespace
此参数适用于使用静态扫描阶段的所有管道。 这是要与管道创建的 SonarQube 实例配合使用的已配置 Kubernetes 名称空间,您可以将其更改为要使用的任何名称空间。
sonarqu可能-scan-command
此参数适用于使用静态扫描阶段的管道。sonarqube-scan-command
指定用于启动 sonarqub 扫描的命令。 如果未设置此参数,那么缺省值为 docker run --network host -v "$SONAR_DIR":/usr/sonar_scan -v "$WORKSPACE/$path":/usr/src "$sonarqube_scanner_image" sonar-scanner -Dsonar.working.directory=/usr/sonar_scan
。
缺省参数使用 Docker sonar-scanner
映像来执行扫描。
对于 Maven Java 项目,将此参数设置为 mvn -Dmaven.repo.local="${WORKSPACE}/.m2" -Dsonar.login="$(cat /tmp/sonarqube-token)" -Dsonar.host.url="$SONAR_HOST_URL" -Dsonar.projectKey="$SONAR_PROJECT_KEY" -Dsonar.projectName="$SONAR_PROJECT_KEY" -Dsonar.working.directory="$SONAR_DIR" sonar:sonar
以将 Maven 计算的类路径用于声纳扫描。
源环境
从中提升应用程序的源环境,这是提升的源库存分支。 缺省值为 master
。 通过将 source-environment
属性添加到有效内容以覆盖此参数的值,使用 Webhook 触发器。
static-scan-retry-count
此参数适用于要在管道中运行的任何静态扫描。 这些扫描使用 API 调用,这可能需要很短的时间才能工作。 因此,如果需要,请重试这些调用。 可以使用此参数来更改重试次数。 默认情况下,该参数设置为 30。
static-scan-retry-sleep
此参数适用于要在管道中运行的任何静态扫描。 这些扫描使用 API 调用,这可能需要很短的时间才能工作。 因此,如果需要,请重试这些调用。 您可以使用此参数更改要等待的秒数。 默认情况下,该参数设置为 10。
摘要重试次数
请使用重试方法来上载证据摘要,以确保其成功。 可以使用此参数来更改重试次数。 默认情况下,该参数设置为 5。
摘要-最大重试时间
请使用重试方法来上载证据摘要,以确保其成功。 您可以使用此参数更改要等待的秒数。 默认情况下,该参数设置为 32。
目标环境
应用程序要部署到的目标环境,这是促销的目标库存分支。 缺省值为 prod
。 通过将 target-environment
属性添加到有效内容以覆盖此参数的值,使用 Webhook 触发器。
目标-环境-用途
此参数用于 CD 管道。target-environment-purpose
确定目标环境的上下文及其使用方式。 有效值为 pre_prod
和 production
。 将任何与 production
无关的更改标记为 pre_prod
。
目标环境详细信息
此参数用于 CD 管道。 它描述了目标环境。
sysdig-扫描
此参数适用于使用扫描工件阶段通过使用 sysdig inline scanner
on icr.io
映像来运行 Sysdig 扫描的管道。