プロジェクトを使用してデプロイ可能なアーキテクチャを複数のリージョンに展開する

このチュートリアルでは 、プロジェクトリソースとインフラストラクチャーをコード・デプロイメントとして定義および管理する成果物の集合。 を使用して、同じデプロイ可能なアーキテクチャのわずかに異なる2つの構成を、2つの異なるリージョンにデプロイする方法を順を追って説明します。

あなたが Example Corp 社のソフトウェア開発者であると想像してください。 御社のインフラストラクチャアーキテクトが Code Engine のデプロイ可能なアーキテクチャ向けにクラウド自動化を発見し、御社のクラウド自動化エンジニアリング 専門 家がビジネスニーズを完全に満たすようカスタマイズしました。 カスタマイズされたデプロイ可能なアーキテクチャは、 IBM Cloud Code Engine 上でのコンテナ化されたアプリケーションのデプロイを自動化するために使用されます。 既存のコンテナイメージが例として使用されます icr.io/codeengine/helloworld。 アプリケーションを最適にサポートするためには、ローカルデータストレージやパフォーマンス、あるいは高可用性の観点から、デプロイ可能なアーキテクチャを複数のリージョンに展開する必要があります。

このチュートリアルでは、架空のシナリオを用いて、プロジェクトを使用して複数のリージョンにデプロイする方法を学習し理解するのに役立ちます。 チュートリアルを完了したら、各ステップを組織のニーズに合わせて変更してください。

開始前に

  1. IBM Cloud アカウントを設定してください

  2. カスタムデプロイ可能アーキテクチャを作成しExample Corp's infrastructure これをプライベートカタログにオンボードします。 Example Corp catalog

  3. このチュートリアルを完了すると、アカウントに費用が発生する可能性があることをご承知おきください。 Code Engine 向けのクラウド自動化は、 カスタマイズされて作成されました Example Corp's infrastructure。 Code Engine の利用に関連する費用の詳細については、 Code Engine の料金ページ をご覧ください。

  4. プロジェクトを作成し、アカウント内でプロジェクトツールリソースを作成する権限を得るには、以下のアクセスロールを必ず取得してください:

    • IBM Cloud プロジェクトサービスにおける編集者の役割。
    • IBM Cloud® Schematics サービスにおける編集者および管理者ロール
    • プロジェクトのリソースグループにおけるビューアーの役割
    • デプロイ可能なアーキテクチャ内の特定のリソースに必要なその他の役割。 Code Engine のクラウド自動化には、 Code Engine サービスの全リソースを対象とするWriterサービスアクセスロールが必要です。

    アクセスと権限の詳細については、 「プロジェクトへのユーザーアクセス権の割り当て」 を参照してください。

  5. 認証方法を設定する。 Secrets Manager に保存されている API キー または 信頼済みプロファイルを使用して、 ターゲットアカウントへのデプロイを認証できます。

    テスト目的で概念実証を展開する? プロジェクトの設定を編集する際に、後からAPIキーを作成できます。 これにより、プロジェクトが現在選択されているアカウントにデプロイすることを許可します。

プロジェクトの作成

Example Corpのインフラストラクチャを構成およびデプロイできるプロジェクトを作成する。

  1. コンソール IBM Cloud で、アイコン ナビゲーションメニュー をクリックします ナビゲーションメニューアイコンメニュー > プロジェクト
  2. 「作成」 をクリックします。
  3. プロジェクトに名前を付けて Example Corp infrastructure ください。
  4. プロジェクトに次の説明を追加してください: Project to manage the different configurations and deployments of Example Corp's infrastructure.
  5. プロジェクトデータが保存されている地域として ダラスを選択する。
  6. リソースグループ用に Default 保持する。
  7. 「作成」 をクリックします。

プロジェクト内に環境を作成する

プロジェクトが作成されたので、設定間で値を共有し、デプロイを容易にする環境を作成する準備が整いました。 環境に追加したプロパティは、その環境を使用している構成に自動的に追加されます。 詳細については、 環境を使用する利点 をご覧ください。 このチュートリアルでは、プロジェクトで再利用できるように、環境に認証方法を追加します。

  1. Example Corp インフラストラクチャプロジェクトで、 [管理] > [環境] を選択します。
  2. 「作成」 をクリックします。
  3. 環境の名前を指定してください Example Corp infrastructure dev
  4. 追加 > 手動で追加... をクリックします
  5. カテゴリの認証を選択してください。
  6. 開始前の 手順で設定した認証方法を指定してください。 APIキーまたは信頼済みプロファイルを使用できます。
  7. 選択した方法に応じて、APIキーを含むシークレットを選択するか、信頼済みプロファイルIDを提供してください。
  8. 「追加」 をクリックして、認証方法を環境に追加します。
  9. 保存をクリックして環境を保存します。

プロジェクトにデプロイ可能なアーキテクチャを追加する

設定 Example Corp's infrastructure を行う前に、デプロイ可能なアーキテクチャをプロジェクト内で見つけ Example Corp catalog 、プロジェクト Example Corp infrastructure に追加する必要があります。

  1. Example Corp インフラストラクチャ プロジェクトで、 [構成] > [作成] をクリックします。
  2. カタログメニューを使用して、プライベートカタログ「」を開きます Example Corp catalog
  3. [タイプ] セクションから [非公開商品 ] を選択し、商品リストをフィルタリングします。
  4. 残りの製品リストから Example Corpのインフラストラクチャを選択してください。
  5. プロジェクトとして Example Corpのインフラストラクチャが選択されていることを確認してください。
  6. プロジェクト設定アイコンをクリックし、設定 構成の名前をに変更します example-corp-us-south
  7. 環境として 「例:コーポレーション インフラストラクチャ開発」 を選択し、 「保存」 をクリックします。
  8. 登録して作成 をクリックする。

デプロイ可能なアーキテクチャをプロジェクトに正常に追加し、構成を定義する準備が整いました。

デプロイ可能なアーキテクチャを構成する

  1. 詳細セクションで情報を確認し、環境 Example Corp infrastructure dev が選択されていることを確認してください。

  2. セキュリティ セクションで、環境に追加した内容に基づいて正しい認証方法が選択されていることを確認します。

  3. 検証中に、コードリスクアナライザによるスキャンがアーキテクチャに対して実行されます。これには一連の要件に基づくコンプライアンススキャンが含まれます。適用可能な Example Corp's infrastructure 要件は含まれていませんが、必要に応じて Workload Protection を通じて要件を含む独自のポリシーを設定できます。 詳細については、 「アーキテクチャの設定」 を参照してください。 Workload Protection のポリシーを使用しない場合は 、アーキテクチャのデフォルトを選択してください。

  4. 入力 セクションから、配置可能なアーキテクチャ構成に必要な入力変数の値を入力します:

    1. 命名規則に使用する prefix 記号 us-south として を入力してください。
    2. デフォルトとして選択してください existing_resource_group_name
    3. リソースを展開する region 対象として us-south を選択してください。
  5. 保存 をクリックします。

  6. 検証 をクリックします。 表示されるモーダルは、進行中の検証に関する詳細情報を提供します。

    検証が失敗した場合、 その失敗の原因を調査 できます。 または、 IBM Cloud Projects サービスの管理者は、 Schematics サービスを通じて結果を確認し、 失敗をオーバーライドして 構成を承認し、それでもデプロイを実行できます。 ただし、パイプラインが失敗した原因がコードリスクアナライザのスキャンによるものであり、検証やプランの失敗によるものではないことを確認してください。 検証またはプランの失敗によりフラグが立てられた障害を上書きすることは推奨されません。設定が正常にデプロイできないためです。 プロジェクトにおけるセキュリティとコンプライアンスの詳細については、 「企業としての継続的なコンプライアンスの実現」 を参照してください。

コンフィギュレーションとデプロイメントのプロセス中、 注意が必要項目を 監視する。 ウィジェットは、設定で発生するあらゆる問題を反映します。

最初の構成を承認してデプロイする

IBM Cloud® プロジェクトサービスの 編集者 として、構成の変更を承認し、構成をデプロイすることができます。 最初の構成をデプロイして、変更が期待通りに動作することを確認することは有益です。 その後、デプロイが成功した場合、2つ目の構成の作成を続行できます。

設定を承認してデプロイする前に、 概要 タブで未解決の 注意が必要 項目に対処する必要があります。

  1. Example Corp infrastructure プロジェクトから、 設定 タブを選択します。
  2. アイコンをクリック オプションオプションアイコンオプション して example-corp-us-south > 前回の検証を表示を表示します。
  3. 承認に関する詳細をコメント欄に追加し、「 承認」 をクリックしてください。
  4. デプロイ をクリックし、デプロイが完了するまで待ちます。

2つ目のデプロイ可能なアーキテクチャを追加して設定する

アーキテクチャを1つのリージョンに構成およびデプロイした後は、それを複製して別のリージョンにアーキテクチャをデプロイできます。

  1. Example Corp infrastructure プロジェクトから、 設定 タブを選択します。

  2. オプションアイコンをクリックし、 オプションアイコンオプション を選択して example-corp-us-south > 複製。 がプロジェクトに追加されます example-corp-us-south-copy-01

  3. オプションアイコンをクリックしてください example-corp-us-south-copy-01 > 編集

  4. 詳細セクションから「 編集 」をクリックし、設定の名前を に変更します example-corp-us-east

  5. 詳細セクションから、環境 Example Corp infrastructure dev が選択されていることを確認してください。

  6. セキュリティ セクションで、作成した環境から取り込んだ情報を確認します。

  7. 入力 セクションで、 編集をクリックし、配置可能なアーキテク チャ構成に必要な入力変数の値を入力します:

    1. 命名規則に使用する prefix 記号 us-east として を入力してください。
    2. デフォルトとして選択してください existing_resource_group_name
    3. リソースを展開する region リージョンとして us-east を選択してください。
  8. 保存 をクリックします。

  9. 検証 をクリックします。 表示されるモーダルは、進行中の検証に関する詳細情報を提供します。

    検証が失敗した場合、 その失敗の原因を調査 できます。 または、 IBM Cloud Projects サービスの管理者は、 Schematics サービスを通じて結果を確認し、 失敗をオーバーライドして 構成を承認し、それでもデプロイを実行できます。 ただし、パイプラインが失敗した原因がコードリスクアナライザのスキャンによるものであり、検証やプランの失敗によるものではないことを確認してください。 検証またはプランの失敗によりフラグが立てられた障害を上書きすることは推奨されません。設定が正常にデプロイできないためです。 プロジェクトにおけるセキュリティとコンプライアンスの詳細については、 「企業としての継続的なコンプライアンスの実現」 を参照してください。

コンフィギュレーションとデプロイメントのプロセス中、 注意が必要項目を 監視する。 ウィジェットは、設定で発生するあらゆる問題を反映します。

2つ目の構成を承認してデプロイする

検証が完了したら、2つ目の構成をデプロイできます。

設定を承認してデプロイする前に、 概要 タブで未解決の 注意が必要 項目に対処する必要があります。

  1. Example Corp infrastructure プロジェクトから、 設定 タブを選択します。
  2. オプションアイコンをクリックしてください example-corp-us-east > 編集
  3. 詳細を表示をクリックして、最後の検証を確認し、変更を承認してください。
  4. 承認に関する詳細をコメント欄に追加し、「 承認」 をクリックしてください。
  5. デプロイ をクリックし、デプロイが完了するまで待ちます。

次のステップ

デプロイが正常に完了すると、アプリケーションは2つの別々のリージョンにデプロイされます。 わずかに異なる2つの構成は、同じ展開可能なアーキテクチャに基づいている。 アプリケーションを見つけるには、コンソール IBM Cloud に移動し、アイコンをクリックします。 ナビゲーションメニューアイコンメニューナビゲーションメニュー > コンテナ** サーバーレスプロジェクト** >

次のチュートリアル「 カスタマイズ可能なオプションの追加 Example Corp's infrastructure」をご覧ください。