インポートおよびエクスポートは、例えば、複数の IBM® UrbanCode Deploy サーバーがあり、コンポーネントを迅速に移動あるいは更新する必要がある場合に特に有用です。
このタスクについて
コンポーネントをインポートする際は、新規コンポーネントを作成することも、既存のコンポーネントをアップグレードすることもできます。
さらに、インポートするコンポーネントがテンプレートから作成されている場合は、そのテンプレートを使用することも、新しいテンプレートを作成することもできます。
注: インポートするコンポーネントで「バージョンの自動インポート」パラメーターが true に設定されている場合、新規コンポーネントは、インポート・サーバーから成果物がアクセス可能である限り自動的にコンポーネント・バージョンをインポートします。
手順
1 つ以上のコンポーネントをインポートするには以下のようにします。
- 「コンポーネントのインポート」ウィンドウを表示します
()。
- コンポーネント定義が含まれる JSON ファイルへのパスを入力するか、
「参照」をクリックしてファイルを選択します。
- 既存のコンポーネントをアップグレードする場合は、「コンポーネントのアップグレード」チェック・ボックスを選択します。コンポーネントを作成するには、このボックスを選択しないままにします。 JSON ファイル内のコンポーネント名 (ファイル自体の名前ではない) が既存のコンポーネントと一致する場合は、
パラメーターは、新しい値で更新されて、プロセスなどの新しい項目が追加されます。
コンポーネントの名前が見つからない場合は、インポート・アクションは無効になります。
注: コンポーネント名は、JSON ファイルの最初のパラメーターになります。例を次に示します。
"name": "helloWorld",
- インポートするコンポーネントがテンプレートから作成されている場合は、
「コンポーネント・テンプレートのアップグレード・タイプ」リストを使用して、テンプレートの使用方法を指定します。 以下のオプションでは、テンプレートがインポート・サーバー上に存在している必要があります。
インポートするコンポーネントがテンプレートから作成されていない場合、これらのオプションは無視されます。
- インポートするコンポーネントのテンプレートを使用するには、「既存テンプレートの使用」を選択します。新規コンポーネントは、インポートするコンポーネントの正確なコピーです。
新規コンポーネントには、インポートするコンポーネントのテンプレートへのポインターが含まれます。
このオプションは、同じテンプレートをベースにしたコンポーネントを数多くインポートする場合に特に有用です。
アップグレードする場合も、コンポーネントはインポートするテンプレートをポイントします。
- テンプレートを作成するには、「新規テンプレートの作成」を選択します。
新規コンポーネントは、インポートするコンポーネントの正確なコピーです。
新規コンポーネントには、新規作成されたテンプレート (インポートするコンポーネントのテンプレートをベースにしている) へのポインターが含まれます。
コンポーネントをアップグレードする場合も、新規テンプレートが作成されます。
- サーバーが新規にインポートされたテンプレートを確実に使用するようにしたい場合は、
「テンプレートがある場合は失敗にする」を選択します。この場合、サーバーに既にテンプレートが含まれていると、インポート・アクションは失敗します。
- フレッシュ・インストールを作成し、サーバーが必ず新しくインポートされたテンプレートを使用するようにしたい場合は、「テンプレートがある場合は失敗にする」を選択します。
コンポーネントを作成する場合は、テンプレートが存在しない限り、新規コンポーネントとテンプレートの両方が作成されます。存在する場合は、コンポーネントはインポートされません。
コンポーネントをアップグレードする場合、インポートするコンポーネントのテンプレートが既に存在すると、アップグレードは失敗します。
- サーバーが必ず新しくインポートされたテンプレートを使用するようにしたい場合には、「テンプレートが存在しない場合は失敗にする」を選択します。
コンポーネントを作成する場合は、テンプレートが存在する場合に限り、新規コンポーネントとテンプレートの両方が作成されます。存在しない場合は、コンポーネントはインポートされません。
コンポーネントをアップグレードする場合、インポートするコンポーネントのテンプレートがインポート・サーバー上に存在しない場合は、アップグレードは失敗します。
- テンプレートをアップグレードするには、「存在する場合は、アップグレード」を選択します。
このオプションは、コンポーネントを作成し、インポート・サーバー上のテンプレートをアップグレードします。
テンプレートが存在しない場合は、新規にテンプレートが作成されます。
- 「実行依頼」をクリックします。