オンボーディング中に展開可能なアーキテクチャを拡張する

デプロイ可能なアーキテクチャをプライベートカタログにオンボードするときに、他のアーキテクチャとスタックして拡張することを選択できます。他のアーキテクチャを追加するときは、アーキテクチャを意図したとおりにデプロイするためにそれらが必要かどうか、またはユースケースを拡張するためにオプションで使用できるかどうかを指定します。オンボーディングが完了すると、連携して動作する複数の展開可能なアーキテクチャで構成された堅牢なエンドツーエンドのソリューションが完成します。

一緒にスタックしたいデプロイ可能なアーキテクチャは、すでにカタログで入手可能ですか? その場合は、それらのアーキテクチャをプロジェクトにスタックし、そのソリューションを別のカタログエントリとしてオンボードできます。現在、プロジェクトにデプロイ可能なアーキテクチャをスタックする場合、オプションまたは交換可能なアーキテクチャを含めることはサポートされていません。したがって、このアプローチは、エンドツーエンドのソリューションを展開するために、スタックするすべてのアーキテクチャが必要な場合に最適です。

デプロイ可能なアーキテクチャを拡張する理由は何ですか?

デプロイ可能なアーキテクチャは、さまざまな理由で拡張できます。たとえば、オンボーディングするアーキテクチャに依存関係が必要な場合は、依存先のアーキテクチャとともにそれをスタックできます。依存関係が必須としてリストされている場合、ユーザーが構成してデプロイするときに、デプロイ可能なアーキテクチャとともにそれが含まれます。

同様に、オンボーディングするデプロイ可能なアーキテクチャのセキュリティをデフォルトで強化するには、セキュリティニーズを満たす他のアーキテクチャをそのアーキテクチャとスタックすることができます。他の展開可能なアーキテクチャが推奨どおりに含まれている場合、組織内のユーザーは、セキュリティガードレールを備えた特定の方法でアーキテクチャを展開できるようになります。推奨アーキテクチャはデフォルトで含まれていますが、ユーザーは削除できます。

また、展開可能なアーキテクチャを拡張して、ユーザーにさらに多くのカスタマイズオプションを提供し、拡張されたユースケースを活用できるようにすることもできます。おそらく、アーキテクチャは、依存関係を満たしたりコンプライアンスを満たしたりする必要がない、別のデプロイ可能なアーキテクチャとうまく連携するでしょう。デプロイ可能なアーキテクチャをオプションとして追加することができ、ユーザーはデプロイ可能なアーキテクチャをプロジェクトに追加するときにそれを含めることを選択できます。

開始前に

デプロイ可能なアーキテクチャをプライベートカタログにオンボードする手順を完了すると、バージョンの詳細を構成するように求められます。 「アーキテクチャの拡張」 に進み、オンボーディングしているアーキテクチャとともに、他のデプロイ可能なアーキテクチャをスタックします。

デプロイ可能なアーキテクチャをすでにオンボードしている場合は、プライベートカタログ内のバージョンを編集し、 「アーキテクチャの拡張」 に進みます。

コードで作業することを好みますか? カタログマニフェストファイルで、オンボードするアーキテクチャとスタックする他のデプロイ可能なアーキテクチャの詳細を指定できます。設定する dependency_version_2 財産に true そして、 dependencies オンボーディングするアーキテクチャに含めるアーキテクチャを指定するための配列。カタログマニフェストの構造化方法の詳細については、「マニフェストファイルをローカルで編集する」を参照してください。

展開可能なアーキテクチャの追加

デプロイ可能なアーキテクチャをオンボードすると、他のアーキテクチャとスタックして拡張できます。他のアーキテクチャを追加するときに関係を指定し、積み重ねているアーキテクチャ全体でユーザーが構成する変数を定義します。以下のステップを実行します。

デプロイ可能なアーキテクチャをカタログにオンボードするときに、 [アーキテクチャの拡張] セクションで [ 追加] をクリックします。
Product メニューを使用して、追加する配置可能アーキテクチャを選択します。カタログ全体でアカウントがアクセスできるデプロイ可能なアーキテクチャを自由に選択できます。
追加するデプロイ可能なアーキテクチャの関係オプションを選択します。アーキテクチャは必須であり、削除できません。これはオプションであり、ユーザーはそれを含めるかどうかを選択できます。または、これは推奨されており、デフォルトで含まれていますが、ユーザーは削除することを選択できます。詳細については、「関係の指定」を参照してください。
オプション: ユーザーの設定に応じて交換可能な 2 つ以上のデプロイ可能なアーキテクチャを追加する場合は、 [アーキテクチャの拡張] テーブルでそれらを選択し、 [スワップ可能としてグループ化] をクリックします。ユーザーはニーズに応じて、使用するアーキテクチャを選択できます。
デプロイ可能なアーキテクチャの追加が完了したら、 [次へ] > [変数の定義] をクリックして、ユーザーの変数を定義します。そこから、展開可能なアーキテクチャを接続して、ユーザーがアーキテクチャを 1 つずつ構成するのではなく、単一のインターフェースで入力を構成できるようにすることができます。詳細については、「ユーザーの変数の定義」を参照してください。

関係を指定する

オンボーディングするアーキテクチャとともにデプロイ可能なアーキテクチャをスタックする場合は、 Relationship を指定するように求められます。追加するデプロイ可能なアーキテクチャと、プライベートカタログにオンボードする全体的なソリューションとの関係は何ですか? [必須]、 [オプション]、 [推奨] の 3 つのオプションから選択できます。次の表は、ユーザーがプライベートカタログからプロジェクトにアーキテクチャを追加するときに、各オプションがエンドツーエンドソリューションのカスタマイズにどのように影響するかを示しています。

関係オプションの説明
オプション	説明
必須	ユーザーがアーキテクチャをプロジェクトに追加したときに含まれます。必要なアーキテクチャは、ソリューション全体が意図したとおりに機能するために必要であるため、ユーザーは削除できません。
オプション	デフォルトでは含まれません。ユーザーは、拡張されたユースケースを活用したい場合、オプションのアーキテクチャを含めることを選択できます。
推奨	デフォルトで含まれていますが、ユーザーは必要に応じて削除できます。たとえば、デプロイ可能なアーキテクチャに IBM Cloud Secrets Manager を推奨として追加することで、安全なデプロイを促進したいとします。そうすると、ユーザーがデプロイ可能なアーキテクチャをプロジェクトに追加すると、 Secrets Manager がデフォルトで含まれるようになります。ただし、秘密を管理するための別のツールがある場合、または Secrets Manager を必要としない場合は、ユーザーはそれを除外することを選択できます。

ユーザーのための変数の定義

デプロイ可能なアーキテクチャを他のアーキテクチャとスタックして拡張した後、ユーザー用の変数を定義する必要があります。最終目標は、展開可能なアーキテクチャをリンクして、ユーザーがアーキテクチャを 1 つずつ構成するのではなく、単一のインターフェースで入力を構成できるようにすることです。以下の問いについて検討してください。

展開可能なアーキテクチャ内のどの入力をユーザーが構成する必要がありますか? これらの入力は、ユーザーが個々のアーキテクチャを 1 つずつ編集することなく構成できるように、製品に追加する必要があります。これを行うには、 「製品に追加」 を選択します。
入力または出力への参照を使用してリンクする必要がある展開可能なアーキテクチャはどれですか? たとえば、あるアーキテクチャの入力が別のアーキテクチャの出力に依存している場合は、入力に参照を追加して出力に接続します。これを行うには、 「変数の参照」 を選択します。

製品に追加した入力のみが出力を参照できます。アーキテクチャを追加し、その入力の 1 つが別のアーキテクチャからの出力を参照する必要がある場合は、その入力に対して [製品に追加] を選択します。次に、追加した入力に対して変数を参照するを選択します。そこから、出力を含むアーキテクチャを選択できます。変数タイプとして 「出力」 を選択し、入力が参照する出力の名前を選択します。
ユーザーにとって必要な入力はすべて解決されていますか? 製品に追加されない必須入力については、それらの入力を解決するための固定値または参照を提供します。これにより、このエンドツーエンドソリューション内のアーキテクチャが接続され、ユーザーによる構成と展開が容易になります。

コンソールではデフォルト値を指定できません。使用 default_value 内の財産 configuration カタログマニフェストファイル内の配列を使用してデフォルト値を指定します。詳細については、「マニフェストファイルをローカルで編集する」を参照してください。
ユーザーは変数を設定するために変数に関する追加情報を必要としますか? 製品に入力変数を追加すると、ユーザーに対する入力の表示方法を変更できます。多くの場合、特に 2 つの類似した変数が含まれている場合、変数または説明に新しい名前を付けると便利です。例えば、オンボーディングするアーキテクチャに region 入力し、 region インフラストラクチャアーキテクチャからの入力も考慮し、入力に名前を付けることを検討してください。 region-infrastructure 製品に追加するとき。意味のある名前を付けると、入力が使用される場所を識別するのに役立ち、構成が容易になります。

製品に追加したすべての入力は、入力変数テーブルに含まれます。追加した変数を削除する必要がある場合は、その変数を選択して 「削除」 をクリックします。

次のステップ

ユーザーに対して変数を定義したら、デプロイ可能なアーキテクチャのオンボーディングを続行します。完了すると、プライベートカタログにアクセスできるユーザーは、デプロイ可能なアーキテクチャをプロジェクトに追加できるようになります。そうすることで、オンボーディングプロセス中に指定した内容に基づいて、含めるアーキテクチャを選択してカスタマイズできます。