製品を作成する

このページでは、Foundry DevOps で新しい製品を作成する手順を説明します。ユーザーは Marketplace のストアフロントから製品の一覧を見ることや、利用可能な製品をインストールすることができます。製品の作成が適しているユースケースについてもご覧ください。

複数の製品を同時にパッケージ化する手順については、複数の製品をパッケージ化するを参照してください。

ストアを選択する

新しい製品を作成するには、製品の公開先となるストアを選択します。既存のストアを選択するか、新しいストアを作成するには、右上のストアを変更を選択します。

新しいストアはプロジェクトに保存され、そのプロジェクトの権限を継承します。具体的には、ストアが属するプロジェクトの編集権限を持つユーザーは、そのストアで新しい製品を作成し、既存の製品を編集できます。また、そのプロジェクトの閲覧権限または編集権限を持つユーザーは、そのストアから製品をインストールできます。

ストアを選択したら、新規製品または新規グループを作成を選択して、製品の作成を開始します。

新しい製品ドラフトを設定する

左上の製品タイトルを設定… 入力ボックスに、製品ドラフトの名前を入力します。

製品ドラフトをはじめる際は、次のいずれかを選択できます。

• リソースの追加： プロジェクト、フォルダー、またはオントロジーからリソースを手動で選択し、出力としてパッケージ化します。
• フォルダー追跡： 製品がソースフォルダーを追跡します。製品の新しいバージョンには、フォルダー内の新しい出力が自動的に取り込まれます。

以下の例では、リソースを手動で追加します。ドラフトはいつでもフォルダー追跡に移行できます。

出力を追加する

出力を追加を選択し、製品ドラフトに含める出力を選択します。これらの出力は、ユーザーが製品をインストールしたときに Marketplace が再作成するリソースです。ファイルを追加を選択すると、Compass ファイルシステム内のほとんどの種類のリソースを選択できます。Compass で選択できないリソースについては、DevOps がオントロジーリソースを追加するなどの専用の選択肢を提供します。

DevOps はリソースの依存関係を自動的に特定するため、最も下流にあるリソースから追加してください。たとえば、Workshop アプリケーションと4個のオブジェクトタイプをパッケージ化する場合は、Workshop アプリケーションのみを追加してください。

DevOps では、出力を一括で追加することもできます。出力を1回限りで一括追加するには、フォルダーからすべてのファイルを追加を選択します。Data Lineage から追加および Workflow Lineage から追加を使用して、依存関係を図で表示したビューからリソースを追加することもできます。製品の変更に合わせてソースフォルダーとの変更を同期し、出力をより自動的に追跡する方法として、ソースフォルダーの追跡を検討してください。

製品ドラフトに出力を追加したら、リソースを選択して、画面の右側に詳細パネルを開きます。

依存関係タブを選択して、出力の依存関係を確認します。DevOps はこれらを入力としても表示します。

入力を追加する

製品ドラフトに出力を追加すると、DevOps は出力の依存関係を入力値として自動的に表示します。完成した製品をインストールするユーザーは、各入力を満たすリソースを指定する必要があります。

製品を設計する際に、入力を出力に昇格させて含めることができます。入力行の省略記号アイコンを選択し、出力に移動を選択して、入力を出力に昇格させます。

複数の入力を選択し、画面下部のポップアップから {N}件を出力に移動を選択して、入力を出力に一括で移動することもできます。

原則として、インストール担当者に独自のデータセットやオブジェクトタイプなど、独自のバージョンのリソースを指定してもらう場合は、その要件を入力として設定してください。代わりに、製品からインストール担当者にリソースを提供する場合は、入力を出力に昇格させてください。

すべての入力を順次出力に昇格させると、製品をインストールするユーザーは、インストール時に何もマッピングする必要がなくなります。

パラメーターやグループなど、一部の種類の入力は、インストール時に DevOps がその設定を必要とするため、出力に移動できません。

特定の入力の詳細情報を表示するには、入力を選択して詳細パネルを開きます。依存関係タブには、この入力を必要とするコンテンツリソースの情報が表示されます。ここから入力のプリセットを設定することもできます。プリセットを使用すると、入力の選択肢を制限し、インストール担当者向けにデフォルト値を指定できます。

呼び出し元が公開 Marketplace API を通じて製品をインストールする場合は、公開前に入力のAPI名を設定してください。これらの名前により、呼び出し元はインストール値を指定する際に入力を識別できます。

入力と出力を管理する

DevOps には、出力数の多い製品の管理に役立つ複数のオプションがあります。インストール時にパッケージ化するリソースの構成を再現するためにフォルダー構造を有効にしている場合は、出力パネルのフォルダーでグループ化オプションを使用して、保存先フォルダー内の出力をプレビューできます。

入力値パネルと出力パネルのリボンにあるフィルターアイコンを選択して、表示するリソースを絞り込むこともできます。たとえば、エラーメッセージがあるリソースや、特定の種類のリソースのみを表示できます。

製品規模の上限

製品に含められる入力と出力は、データセットの列やオブジェクトタイプのプロパティなどのネストされたリソースを含め、合計15,000個までです。ほとんどの製品はこの上限を下回ります。上限に近づいている場合に確認すべき数は、追加したリソースの数ではなく、それらのリソースから展開される入力と出力の数です。

DevOps は製品を作成する際に製品サイズを検証します。上限の75%以上になると、左下に製品制限カウンターが表示され、ドラフトのステータスパネルに警告が表示されます。上限の100%に達すると、警告はブロッキングエラーになり、続行するには出力を外すか、製品を再構成する必要があります。

製品制限カウンターの詳細の表示を選択すると、製品パッケージの制限ダイアログが開きます。このダイアログには、入力と出力の合計数が上限と比較して表示され、リソースの種類別の内訳も表示されます。

パッケージ化されたデータセットへの列の追加といった通常の変更によって、後のバージョンで上限を超える可能性があるため、警告が表示された時点で対処してください。製品が大きすぎる場合は、いくつかの小さな製品に分割してまとめてパッケージ化し、DevOps がそれらの間の依存関係を解決できるようにすることを検討してください。

リンクされた製品をプレビューする

製品の左パネルからリンクされた製品タブを選択して、製品の入力を提供できる、利用可能なすべてのリンクされた製品をプレビューします。

入力値テーブルのリンクされた製品でグループ化オプションを使用して、上流のリンクされた製品がそれぞれ提供する入力をプレビューすることもできます。

製品のドキュメントを追加する

製品の左パネルからドキュメントタブを選択して、ストアフロントで製品の一覧を見ているユーザーに表示される情報を追加します。説明セクションに製品の短い説明を入力してから、サムネイルとして使用する画像を追加します。

製品の内容のプレビューとして、追加の画像を追加できます。必要に応じて、Markdown ↗ 構文を使用し、製品の詳しい使用手順を含む、より長い製品説明を入力します。

製品の設定を構成する

設定タブを選択して、製品の追加設定を構成します。

フォルダー構造

フォルダー構造をオンにしてフォルダー構造を有効にすると、インストール時に DevOps が元の構成と一致するフォルダーを作成します。

DevOps は最下位の共通祖先までのフォルダーをパッケージ化します。この共通祖先は、インストール時にインストール先のプロジェクトに置き換えられます。

製品のリソースが専用のフォルダーまたはプロジェクト内に整理されている場合は、製品の進化に合わせて出力管理を自動化できるよう、ソースフォルダーの追跡を検討してください。

インストールモード

インストールモードを使用して、製品のすべてのインストールに適用されるデフォルト設定を指定します。これらの設定は、インストールごとに変更できます。

• 本番環境： すべてのインストールを一元管理し、自動アップグレードなどの機能を使用する場合に推奨します。デフォルトでは、インストールの自動アップグレードは無効になっています。インストール担当者には、安全なアップグレードを確保するためにプロジェクトをロックダウンする選択肢が表示されます。
• シングルトン： 本番モードと同じ設定ですが、スペースとオントロジーの組み合わせごとに、製品のインストールは1件のみに制限されます。
• ブートストラップ： インストール担当者が独自のカスタマイズ作業の出発点として製品を使用することが想定される場合に推奨します。デフォルトでは、インストールの自動アップグレードは無効になっており、インストール担当者は編集アクセス権を持つ任意の場所にインストールできます。

ビルド設定

ビルド設定を使用して、Marketplace のインストールジョブ中に DevOps がデータセットとモデルを自動的にビルドするかどうかを指定します。これにより、ジョブの完了時には、新しくデプロイされたリソース全体のすべてのデータセットに DevOps によってデータが取り込まれた状態になります。

レビューして公開する

製品の準備が整ったら、公開を選択して、製品をストアフロントで利用可能にします。これにより、変更をレビューして公開ポップアップが開き、製品の変更内容をレビューして変更ログの説明を追加できます。公開には、製品のサイズに応じて最大数分かかる場合があります。