アプリケーション

1. ソースプロバイダを Git Repos and Issue Tracking として選択します。
2. ツールチェーンのデフォルトの動作は、デフォルトのサンプル・アプリケーションを使用するです。 ツールチェーンは現在、既存の Git Repos and Issue Tracking リポジトリへのリンクのみをサポートしている。 独自のアプリケーション/サービス・ソースコード・リポジトリを使用する場合は、以下を参照してください：

• DevSecOpsに独自のアプリを持ち込む。
• DevSecOpsパイプラインの自動設定 は、パイプラインコンフィギュレーション機能の推論された'DevSecOps使用している。

3. 新しいリポジトリ名にユニークな名前を入力します。
4. 「続行」 をクリックします。

インベントリー

インベントリー・リポジトリーは、CI ツールチェーンでビルドされた成果物の詳細を記録するものです。

1. テンプレートで提供されるデフォルトの設定を受け入れるか、または要件に応じて設定を編集することができます。
2. 「続行」 をクリックします。

問題

問題リポジトリーには、CI パイプラインの実行中に検出された問題が記録されます。

1. テンプレートで提供されるデフォルトの設定を受け入れるか、または要件に応じて設定を編集することができます。
2. 続けるをクリック

秘密

トグルを使用して、ツールチェーンに追加する秘密の保管庫統合を指定します。 詳細は IBM Cloudの秘密の管理 を参照。

CI ツールチェーンでは、 任意のシークレット と IAM 資格情報 のシークレット・タイプのみがサポートされます。

1. このチュートリアルでは、シークレットのボールトとして IBM Cloud® Secrets Manager を使用します。 「リージョン」、 「リソース・グループ」、および 「サービス名」 の各フィールドには、選択可能な項目に基づいて自動的にデータが取り込まれます。 ドロップダウンインジケータを選択すると、他の選択肢が表示されます。
2. Secrets Manager インスタンス名を入力します。
3. 認証タイプを選択します。
4. 「続行」 をクリックします。

エビデンス・ストレージ

エビデンスロッカーは、 DevSecOps CIパイプラインによって生成されるすべてのエビデンスと成果物を保管する。

1. IBM Cloud Object Storageバケットスライダを切り替えて、次のページで設定できるIBM Cloud Object Storageバケットにすべての証拠を保存します。
2. デフォルト設定を受け入れる。
3. 「続行」 をクリックします。

クラウド Object Storage バケット

コンプライアンス証拠保管庫として機能させるには、 IBM Cloud® Object Storage インスタンス と Cloud Object Storage バケット が必要です。

1. Cloud Object Storageインスタンス、バケット名、CloudObject Storageエンドポイントフィールドは自動的に入力されます。
2. サービスID APIキーを入力します。
   • 推奨: 鍵アイコンをクリックすることにより、シークレット・ボールトから既存の鍵をインポートできます。
   • 既存のキーをコピー＆ペーストすることもできる。
3. 「続行」 をクリックします。

エンドポイント・フィールドは任意である。 ツールチェーンのセットアップ中またはパイプラインの実行中に、エンドポイントを選択または指定することをお勧めします。

デプロイ

アプリケーションをデプロイするターゲットの Kubernetes クラスターを構成します。

1. デフォルトのアプリ名 hello-compliance-app を使用してください。

2. IBM Cloud API Keyを入力してください。 APIキーは、いくつかのタスクで IBM Cloud CLIツールと対話するために使用されます。

   • 推奨: 鍵アイコンをクリックすることにより、シークレット・ボールトから既存の鍵をインポートできます。
   • 既存のキーをコピー＆ペーストすることもできる。
   • 新しいキーは、ここで「 New +」をクリックして作成できます。

   新しく生成された API キーは、すぐにシークレット・ボールトに保存できます。

3. APIキーが有効で十分なアクセス権がある場合、Container Registry, Container Registry 名前空間, デブ・クラスター地域, リソースグループ, クラスタ名, クラスタ名前空間 が自動的に入力されます。 これらのフィールドは、あなたの設定に合わせて変更することができます。

4. 「続行」 をクリックします。

成果物の署名

ツールチェーンによって構築され、インベントリに記録された成果物は、本番環境にデプロイされる前に署名されなければならない。

1. GnuPG秘密鍵を入力する。 あるいは、NEW をクリックして新しいGPGキーを作成することもできます。 詳しくは、GPGキーを生成する を参照してください。
2. 「続行」 をクリックします。

DevOps Insights

IBM Cloud DevOps Insights はツールチェーンに含まれている。 すべてのデプロイメントおよび環境からの、すべてのビルドのパイプライン・テスト結果を表示します。

1. デフォルトの設定を受け入れる。
2. 「続行」 をクリックします。

SonarQube

ツールチェーンの静的コード解析ツールとして SonarQube を設定します。 SonarQube は、ソース・コードの全体的な正常性と品質の概要を提供し、新しいコード内で見つかった問題を強調表示します。 静的コード・アナライザーは、ヌル・ポインタの非参照、ロジック・エラー、複数のプログラミング言語のリソース・リークなど、厄介なバグを検出する。

1. デフォルト設定を受け入れる。
2. 「続行」 をクリックします。

オプションのツール

CI-PR パイプラインの実行

ci-pr pipeline を開始するには、アプリケーション・リポジトリにマージ・リクエストを作成する必要があります。

1. CI toolchainのページから、ci-pr pipeline タイルをクリックします。 デフォルトでは、compliance-app-<timestamp> という名前で作成されます。

2. masterブランチからブランチを作成する。

3. アプリケーションのコードを更新するか、readmeファイルを追加し、変更を保存する。

4. マージリクエストを送信をクリックします。

5. CI toolchainページで、 pr-pipeline タイルをクリックする。 ci-pr pipeline がマージリクエストの作成によってトリガーされることを確認してください。

6. ci-pr pipeline の実行が完了するまで待つ。 アプリケーションリポジトリにある対応するマージリクエストは、PRパイプラインのすべてのステージが正常に終了するまで、Pending の状態にあります。

7. PRパイプラインの実行が成功したら、パイプラインをクリックして、完了した多数のステップを確認し、ページを表示します。

   

8. Merge request にアクセスし、変更をアプリケーションリポジトリの master ブランチにコピーするようにリクエストをマージします。

CI パイプラインの実行

以下のいずれかの方法で CI パイプラインを開始します。

• 自動: PR パイプラインが正常に実行された後に、その PR を承認してマスター・ブランチにマージします。
• 手動で：CI パイプラインを手動でトリガーするには、 Delivery Pipeline カードを選択し、 パイプラインの実行をクリックし、 手動トリガーを選択します。

このチュートリアルでは、コードの変更をアプリケーションリポジトリのmasterブランチにマージした後にCIパイプラインが起動しました。

1. CI toolchain ページで、 ci-pipeline タイルをクリックする。

2. パイプライン名に対して実行をクリックします。 パイプラインの実行を観察する。 パイプラインの実行が完了するのを待つ。

3. CIパイプラインの実行が成功したら、パイプラインをクリックして完了したステップを探索し、画面キャプチャのようなページを表示する。

   

4. 画面キャプチャに示すように、DevOps Insights タイルをクリックして、Quality Dashboard ページで収集されたエビデンスを確認します。

   

   また、セットアップ中に IBM Cloud Object Storage バケットが有効化されている場合、証拠を確認することもできます。 パイプラインの実行に失敗があるかどうかを評価するには、パイプラインの最終ステップをチェックする必要があります。

実行中のアプリケーションの表示

CI パイプラインが正常に実行されると、サンプル・アプリケーションが Kubernetes クラスターにデプロイされます。

アプリケーション URL は、CIパイプライン実行の deploy-dev タスクの run stage ステップのログの最後にあります。 この URL、アプリケーションが動作していることを確認する。

パイプラインのカスタマイズ

リファレンス継続的インテグレーションおよび継続的デプロイメントツールチェーンで提供される様々なパイプラインは、Tekton Pipelinesの Continuous Delivery サポートに基づいています。 パイプラインのカスタマイズについての詳細は、ユーザーがパイプラインをカスタマイズするには?