Terraformを使ってCIツールチェーンをセットアップする

インフラストラクチャー・コード

インフラストラクチャコードリポジトリは、CIツールチェーンとパイプラインがビルドし、テストし、ターゲット成果物を提供するプロジェクトまたはモジュールである。 インフラコードリポジトリはGitHub Enterpriseにホストされています。 一貫性を保つために、このチュートリアルでは Git Repos and Issue Trackingを参照します。

インフラコードのデフォルト情報を確認する：

1. デフォルトのサンプルを使用する. ツールチェーンの既存の IaC リポジトリをリンクする場合は、「 Bring your own infrastructure code 」を選択し、「 Repository URL 」フィールドに入力します。 ツールチェーンは現在、既存の Git Repos and Issue Tracking リポジトリへのリンクのみをサポートしている。 詳細については 、「Bring your own infrastructure code to DevSecOps 」をご覧ください。
2. 新しいリポジトリ名に名前を入力します。
3. 「続行」 をクリックします。

インベントリー

インベントリ・リポジトリは、CIツールチェーンによって作成された成果物の詳細を記録する。

1. テンプレートで提供されるデフォルトの設定を受け入れることができます。
2. 「続行」 をクリックします。

問題

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

1. テンプレートで提供されるデフォルトの設定を受け入れることができます。
2. 続けるをクリック

秘密

Managing IBM Cloud secrets で説明するように、トグルを使用してツールチェーンに追加する秘密のデータ保管庫統合を指定します。

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 インスタンス と バケツ がなければ、コンプライアンス・エビデンス・ロッカーとして機能しません。

1. Cloud Object Storageインスタンス、バケット名、CloudObject Storageエンドポイントフィールドは自動的に入力されます。
2. サービスID APIキーを入力します。
   • 好ましい：既存の鍵は、鍵アイコンをクリックすることで、秘密データ保管庫からインポートできます。
   • 既存のキーをコピー＆ペーストすることもできる。
3. 「続行」 をクリックします。

エンドポイント・フィールドは必須ではない。 ツールチェインのセットアップ中またはパイプラインの実行中に、エンドポイントを選択または指定できます。

デプロイ

Terraform の状態を保持する Schematics ワークスペースを設定します。 ワークスペース名が与えられない場合、toolchainはデフォルトのSchematicsワークスペースを ToolchainName-ToolchainId-PipelineID で作成します。

1. IBM Cloud API Keyを入力してください。 APIキーに十分なアクセス権がある場合。 Schematicsワークスペース、Gitリポジトリ、リソースグループの詳細が自動的に入力されます。 これらのフィールドは、あなたの設定に合わせて変更することができます。

   • 好ましい：既存の鍵は、鍵アイコンをクリックすることで、秘密データ保管庫からインポートできます。
   • 既存のキーをコピー＆ペーストすることもできる。
   • 新しいキーは、ここで「 New +」をクリックして作成できます。

   新しく生成されたAPIキーは、すぐに秘密の保管庫に保存することができる。

2. 回路図ワークスペース名を入力します。

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

署名

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

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

オプションのツール

pr パイプラインの実行

pr-pipeline を開始するには、アプリケーション・リポジトリにマージ・リクエストを作成します：

1. CI toolchainページから、アプリケーションリポジトリタイルをクリックします。 デフォルトでは、 compliance-app-<timestamp> という名前で作成されます。

2. メイン・ブランチからブランチを作成します。

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

4. マージリクエストを送信

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

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

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

   

8. マージリクエストに戻ります。

9. 変更をアプリケーションリポジトリのメインブランチにコピーするように、リクエストをマージします。 CIパイプラインが自動的にトリガーされることを確認する。

CI パイプラインの実行

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

• 自動的に: PR パイプラインが成功した後、PR を承認してメインブランチにマージします。
• 手動: CIパイプラインを手動でトリガーするには、 Delivery Pipeline カードを選択し、 パイプラインの実行をクリックし、 手動トリガーを選択します。

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

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

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

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

   

CIパイプラインのすべてのコンプライアンスチェックの証拠は、証拠ロッカーリポジトリにアップロードされますが、IBM Cloud Object Storageバケットにもアップロードされます。

パイプラインの実行に失敗があるかどうかを評価するには、パイプラインの最終ステップをチェックします。

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

パイプラインのカスタマイズについての詳細は、ユーザーがパイプラインをカスタマイズするには?