コード・スポット

コード・スポットは、サポートされているソース・コード言語に関連している：

• Node.js(npm、YarnまたはGradleを使用)
• Java（MavenまたはGradleを使用）
• Golang
• Python
• Dockerfile
• Terraform設定言語

code スポットは以下の処理を行う：

• building: 与えられたソースコードのビルドを実行するツールを定義する。
• unit-testing: ビルド結果のユニットテストを実行するツールを探す。

配備スポット

deployment スポットは、配備リソースと配備ツールを含む配備ビークルを見つける。 deployment スポットには、配備ツールを列挙する配備プロセスがある。 現在サポートされている配備車両は以下の通り：

• Pod」、「ReplicaSet、「ReplicationController、「Deployment、「Daemonset、「StatefulSet、「Job、「Cronjob、「NetworkPolicy、「Ingress、「Service、「Route ようなKubernetesリソース定義 - ツールとしての kubectl

• Websphere Liberty アプリケーション・カスタム・リソース- ツールとしての kubectl

• Open Libertyアプリケーション・カスタム・リソース- 'クベクトル をツールとして使用する

• Helm- 道具としての舵

• Terraformの設定-IBM Cloud Schematics または Terraform CLI をツールとして使用する

• ワジ「DeploymentMethodカスタムリソース- 'ワジ・デプロイ をツールとして使用する

• IBM Cloud Code Engine がデプロイ用に設定されている 場合の Dockerfile- IBM Cloud Code Engine CLI をツールとする

アクセプタンス・テスト・スポット

acceptance-test スポットは、実行する受け入れテスト・スイートを特定する。 acceptance-test スポットには、受け入れテスト・スイートを実行するツールを特定する 'acceptance-testing プロセスがある。

ダイナミックスキャンスポット

dynamic-scan スポットは、ダイナミック・スキャンの場所を特定する。 ダイナミックスキャンスポットには、ダイナミックスキャン中に呼び出されるスキャンツールをリストアップする「scanning プロセスがある。

OWASP ZAP スキャン は、サブウェブフック・トリガーを起動する唯一のサポートされたツールです。

リリーススポット

release スポットは、リリースプロセスを示す。 リリーススポットには、リリース段階で実行するツールをリストアップした「releasing プロセスがある。 現在、リリースプロセスでサポートされているツールは以下の通り：

• セマンティック・リリース
• maven deploy フェーズの maven。

インジェクション・ブランチの設定

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) 'ibmcloud code-engine buildrun コマンドの代わりにDockerCLIを使用するかどうかを示します。
• 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)PythonPoetry バージョンのヒント。
• discover-python-unittest-from-ancestor: (デフォルト: false) は、python unittest の探索の開始点として祖先ディレクトリを使用することを示します (例えば、python の unittest ファイルに最も近い requirements.txt (もしあれば) ではなく、リポジトリのルートにある requirements.txt を含むディレクトリからユニットテストを探索するため)。

Terraform 構成

Terraformのデプロイプロセスを設定するには、以下のパイプライン環境プロパティを使用します：

• terraform-deployment: (デフォルト: 'false) デプロイメント手段としてのSchematicsを無効にし、TerraformとCloud Object Storageを状態保存に使用します。

Helm 構成

Helm リリースプロセスを設定するには、以下のパイプライン環境プロパティを使用します:

• helm-oci-registry-support: (デフォルトは false) リリースステップでヘルムチャートを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) イメージ以外の保存されたアーティファクトに対して、DevSecOpsCLI のアーティファクトアップロードを使用してCloud Object Storageバケットへのアーティファクトアップロードを有効にします。

パイプライン実行段階における環境変数のインジェクション

InferredDevSecOpsPipeline Configuration機能は、ステージ実行中にパイプラインとトリガーのプロパティを環境変数としてエクスポートする'export-properties ユーティリティを提供します。 このユーティリティは、カスタマイズされたすべての段階で呼び出される：

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

ツールの実行と設定

InferredDevSecOpsPipeline Configuration 機能のいくつかのツールは、補完的なコンフィギュレーションを推論するために、パイプラインとトリガーのプロパティを使用します。

デフォルトでブランチプロテクションを有効にする

DevSecOpsPRとCIパイプラインは、デフォルトでソースコードリポジトリのブランチ保護を有効にする。 この検証はコード設定段階で行われる。

ブランチプロテクションを無効にする

分岐保護を無効にするには、「setup-branch-protection プロパティを「false」に設定する。

ブランチ・プロテクション・ステータス・チェックのカスタマイズ

分岐保護状態チェックの接頭辞 をカスタマイズするには、「branch-protection-status-check-prefix プロパティを設定する。 デフォルトのプレフィックスは tekton です。

プライベート・リポジトリ用にPoetryを設定する

ポエトリー（pyproject.toml がコードスポットとして識別される）を使用し、依存関係をフェッチするための代替ソースやリポジトリが定義されている場合、次のようになる：

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

あるいは、 ポエトリーが関係する場合（すなわち、 build-backend が poetry.core.masonry.api に等しい build-system セクションを含む pyproject.toml が、特定されたリリーススポットである）、プライベートレジス トリを認証するためにクレデンシャルを提供する必要があるかもしれな い。

IBM Cloudのプライベート・リポジトリで認証する

この'local ソースリポジトリの認証情報を提供する必要がある。 認証情報の設定に関する詩のドキュメント によると、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パイプライン、またはトリガーレベルのプロパティで、'ci_settings.xml に値を設定したパイプライン環境プロパティ maven-user-settings-file-path を定義する。

さらに、解決すべき'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 に設定する。