代碼點

代碼點與受支援的源代碼語言相關，包括：

• Node.js （使用 npm、Yarn 或Gradle ）
• Java （使用 Maven 或Gradle ）
• Golang
• Python
• Dockerfile
• Terraform 配置語言

code 點處理以下程序：

• building：定義執行給定原始碼建置的工具。
• unit-testing：找到對建置結果執行單元測試的工具。

部署點

deployment 點定位部署工具，包括部署資源和工具。deployment 點有一個列出部署工具的部署流程。 目前支援的部署車輛有：

• Kubernetes資源定義，如 Pod、ReplicaSet ReplicationController、' Daemonset Deployment、StatefulSet、'code6'、Job、Cronjob、NetworkPolicy、Ingress、Service、Route- kubectl 作為工具

• Websphere Liberty 應用程式自訂資源- kubectl 作為工具

• Open Liberty應用程式自訂資源- kubectl 作為工具

• Helm圖表- Helm 作為工具

• Terraform 配置- IBM Cloud Schematics 或 Terraform CLI 作為工具

• Wazi DeploymentMethod自訂資源- Wazi 部署 為工具

• IBM Cloud Code Engine 已設定部署 時的 Dockerfile- IBM Cloud Code Engine CLI 為工具

驗收測試點

acceptance-test 點找到要執行的驗收測試套件。acceptance-test 點有一個 acceptance-testing 流程，用來識別執行驗收測試套件的工具。

動態掃描點

dynamic-scan 點標識動態掃描的位置。 動態掃描點有一個 scanning 進程來列出動態掃描期間呼叫的掃描工具。

OWASP ZAP 掃描 是唯一支援啟動子 Webhook 觸發器的工具。

發佈點

release 點定位發布流程。 發佈點有一個 releasing 流程，列出了發布階段要運行的工具。 目前支援的發布流程工具有：

• 語意釋放
• Maven 與 maven deploy 階段。

配置注入分支

您可以使用 inferred-devsecops-branch 管道屬性配置用於注入DevSecOps推斷檔案的分支名稱。 預設值為 inferred-devsecops。

使用 push-inferred-pipeline-configuration-files 管道屬性 ( push-polyglot-files 屬性已被廢棄，改用 push-inferred-pipeline-configuration-files 屬性) 來啟用或停用 inferred-devsecops 分支的建立與更新：

忽略斑點

您可以使用正規表示式在擷取過程中忽略特定點。 可用的配置選項如下：

• ignore-code-spot-pattern：忽略與指定正規表示式相符的代碼點。
• ignore-deployment-spot-pattern：忽略與指定正規表示式相符的部署點。
• ignore-dynamic-scan-spot-pattern：忽略與指定正規表示式相符的動態掃描點。
• ignore-acceptance-test-spot-pattern：忽略與指定正規表示式相符的驗收測試點。
• ignore-release-spot-pattern：忽略與指定正規表示式相符的發佈點。

Code Engine配置

如果您使用 IBM Cloud Code Engine 進行部署，請指定 Code Engine 專案，並使用下列管道環境屬性設定建立程序：

• code-engine-project：指定Code Engine專案。
• code-engine-build-use-native-docker：（預設：false ）指示是否使用Docker CLI 而不是 ibmcloud code-engine buildrun 命令。
• code-engine-disable-buildpacks-strategy: (預設 false) 表示建立程序不應使用 buildpacks 策略 (僅在 code-engine-project 已設定時有效)
• root-as-build-context: (預設值: false ) 表示 Dockerfile 相關建置工具 (如 docker 或 code-engine ) 的建置上下文應該使用儲存庫的根作為建置上下文，而不是包含 Dockerfile 的資料夾。

容器映像構建配置

• container-image-builder: (預設為 docker) 針對 Dockerfile 相關的建置作業，請指定用於建置容器映像的工具 (docker 或 podman)。
• root-as-build-context: (預設值：false) 表示相關建置工具（如 docker, podman``Dockerfile 或 code-engine）的建置上下文應使用儲存庫根目錄作為建置上下文，而非包含 Dockerfile 的資料夾。

Golang 組態

若要設定 Golang 的點擷取程序，請設定下列管道環境屬性：

• go-ignore-main：（預設：false ）指示代碼點提取是否不關注主來源參數的主包和主函數檢測。
• go-output：指定 go build 指令的可執行輸出檔。

Gradle配置

若要設定 Gradle 設定、單元測試、建立工件和驗收測試的任務，請使用下列管道環境屬性：

• gradle-setup-tasks：（預設：assemble ）用於設定階段的Gradle任務的逗號分隔清單。
• gradle-unit-testing-tasks：（預設：test ）單元測試階段的Gradle任務的逗號分隔清單。
• gradle-build-artifact-tasks：（預設：build ）建構工件階段的Gradle任務的逗號分隔清單。
• gradle-acceptance-testing-tasks：用於驗收測試階段的Gradle任務的逗號分隔清單。

NPM配置

您可以設定NPM單元測試和驗收測試腳本檢測。

• hint-npm-unit-testing-script：（預設：test ）NPM 單元測試腳本偵測的提示。
• hint-npm-acceptance-testing-script：（預設：acceptance-test ）NPM 驗收測試腳本偵測的提示。

Python配置

若要設定 Python Poetry 版本，請使用下列管道環境屬性：

• hint-python-poetry-version：（預設：1.8.2 ） Python Poetry 版本的提示。
• discover-python-unittest-from-ancestor: (預設值: false) 表示使用祖先目錄作為 python unittest 發現的起點 (例如，為了從儲存庫根目錄中包含 requirements.txt 的目錄而不是最接近 python unittest 檔案的 requirements.txt (如果有的話) 發現單元測試)。

Terraform 配置

要配置 Terraform 部署流程，請使用下列管道環境屬性：

• terraform-deployment：（預設值：false ）停用Schematics作為部署工具，轉而使用 Terraform 和Cloud Object Storage進行狀態儲存。

Helm 配置

要設定 Helm 發布流程，請使用以下管道環境屬性：

• helm-oci-registry-support: (預設為 false) 啟用在發佈步驟中將 Helm 圖表推送至 OCI 註冊表的功能。
• configuration-file-pattern-<config_file_type>: 定義一個模式，用以識別特定類型的配置檔案。 例如，configuration-file-pattern-dev-config=chart/dev-values.yaml 會選取檔案 chart/dev-values.yaml 作為類型為 dev-config 的構建產出。

工件上傳

若要設定工件上傳程序，請使用下列管道環境屬性：

• artifact-upload-to-devsecops-cos：（預設值：false ）透過使用DevSecOps CLI 工件上傳非影像儲存的工件，啟用工件上傳至Cloud Object Storage桶。

管道執行階段的環境變數注入

推斷的DevSecOps管道配置功能提供了一個 export-properties 實用程序，用於在階段執行期間將管道和觸發器屬性匯出為環境變數。 在每個自訂階段都會呼叫此實用程式：

export-properties "GLOBAL" && export-properties "${STAGE^^}"

工具執行和配置

推斷DevSecOps管道配置功能中的一些工具使用管道和觸發器屬性來推斷補充配置。

預設啟用分支保護

DevSecOps PR 和 CI 管道預設啟用原始碼儲存庫上的分支保護。 此驗證發生在程式碼設定階段。

停用分支保護

若要停用分支保護，請將 setup-branch-protection 屬性設為 false。

自訂分支保護狀態檢查

若要自訂 分支保護狀態檢查的前綴，請設定 branch-protection-status-check-prefix 屬性。 預設前綴是 tekton。

為私有儲存庫配置詩歌

使用 Poetry 時（ pyproject.toml 被標識為程式碼點）並定義替代來源或儲存庫來取得依賴項，例如：

[[tool.poetry.source]]
name = "local"
url = "<artifactory-url>"
secondary = true

或涉及 Poetry 時 (即 pyproject.toml 包含 build-system 區段，而 build-backend 等於 poetry.core.masonry.api 是已識別的釋放點)，則可能需要提供憑證以驗證私有註冊表。

使用IBM Cloud中的私有儲存庫進行身份驗證

需要提供此 local 來源儲存庫的憑證。 有關憑證配置的 Poetry 文件 表示提供 http 使用者和密碼的環境變數應為 POETRY_HTTP_BASIC_LOCAL_USERNAME 和 POETRY_HTTP_BASIC_LOCAL_PASSWORD。

使用 環境變數注入 功能，並新增以下管道環境屬性：

• 具有適當值的 ENV_GLOBAL_POETRY_HTTP_BASIC_LOCAL_USERNAME （文字）
• 具有適當安全值的 ENV_GLOBAL_POETRY_HTTP_BASIC_LOCAL_PASSWORD （安全性）

在IBM Cloud中為自訂設定檔配置 Maven

如果您的 Maven 專案定義了具有自訂檔案名稱的特定設定文件，例如 ci-settings.xml，請在 PR、CI 管道中定義管道環境屬性 maven-user-settings-file-path 並將值設為 ci_settings.xml 或觸發電平屬性。

此外，如果有一些 env.<VARIABLE> 需要解決，例如：

    <server>
      <username>${env.MAVEN_USERNAME}</username>
      <password>${env.MAVEN_PASSWORD}</password>
      <id>central</id>
    </server>

使用 環境變數注入 功能透過新增 2 個管道屬性（在 PR 和 CI 管道中）來提供這些變數：

• ENV_GLOBAL_MAVEN_USERNAME （文字）以及用於 Maven 使用者名稱的值
• ENV_GLOBAL_MAVEN_PASSWORD （安全性）以及用於 Maven 密碼的值

為 Go 建置啟用靜態連結

預設情況下，go build 產生動態連結的二進位。 要在Docker容器中使用它，請在建置期間透過設定 CGO_ENABLED=0 來啟用靜態連結。

配置Go建構的環境變數

若要啟用靜態鏈接，請使用 環境變數注入 功能在 CI 管道中新增以下管道環境屬性：

• ENV_SETUP_CGO_ENABLED 其值設定為 0