プライマリ・インスタンスからのMetadataの移行

プライマリ・インスタンスからスタンバイ・インスタンスにメタデータをエクスポートします。

Oracle Integrationメタデータは、接続、統合、参照、ライブラリおよびパッケージで構成されます。すべての統合デプロイメントでプライマリ・インスタンスを構成したら、インスタンスからメタデータをエクスポートし、スタンバイ・インスタンスにインポートできます。これは最初の1回かぎりのタスクです。次のいずれかのメソッドを使用してメタデータをエクスポートできます:

REST APIを使用してメタデータをエクスポートし、同じものをインポートします。
Oracle Integration UIを使用して、メタデータをエクスポートおよびインポートします。詳細は、「Oracle Integration Generation 2のプロビジョニングと管理」の「インスタンス間での設計時メタデータのエクスポートおよびインポート」を参照してください。

ノート:

前述のいずれかのメソッドを使用する前に、アーティファクトを格納するためにOCI Object Storageバケットが必要です。

その後、継続的インテグレーション継続的デプロイメント(CICD)を使用して、インスタンス間でメタデータを同期できます。「Metadata同期の自動化」を参照してください。

ノート:

メタデータ移行を含むすべての管理タスクには、元のインスタンス・ホスト名を使用する必要があります。
セカンダリ・インスタンスで作成された接続が「アクティブ」状態にならないように、アーティファクトをアクティブ化せずにインポートすることをお薦めします。アーティファクトをインポートしたら、接続を手動でテストしてアクティブ化できます。それ以外の場合は、「Oracle Integration Generation 2のためのREST API」の「接続RESTエンドポイント」を同じものに使用することもできます。

REST APIを使用してインスタンス間でメタデータを同期するには:

プライマリ・インスタンスからメタデータをエクスポートします。次のpostmanまたはcurlコマンドを使用してREST APIを起動します。このアクションは、メタデータをOCI Object Storage Cloud Serviceバケット・インスタンスにアップロードします。

POST
http:/host:port/ic/api/common/v1/exportServiceInstanceArchive
リクエスト・ヘッダー:

Content-Type →application/json

リクエスト・ペイロード:
```
{     
          "jobName":"Pod1_Metadata"   -  If jobName is omitted filename will default to
          "archive_Local_Suite_Instance-<jobId>.zip",     "overwrite":false,      - defaults to false, will return error if
          archive file already exists     "exportSecurityArtifacts":true,    
          "exportAppRoleMembers":true,     "description":"Export description",
              "storageName",   - name of storage configuration, this can be used instead of
          storageInfo, if both are defined storageInfo will take precedence    
          "storageInfo":{        
          "storageUrl":"https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/<bucket
          name>",
          "storageUser":"<OCI user name>",        
          "storagePassword":"<Auth Password>”     }
      }
```
レスポンス・ヘッダー:
Location →http://host:port/ic/api/common/v1/exportServiceInstanceArchive/483
レスポンス・ペイロード:
```
{
          “jobId”: “483”, “location”:
          “https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/<bucket
          name>”, “status”: “NOT_STARTED”
         }     
```
Response Status:
- 202 受入済 - エクスポート・ジョブが受け入れられました。
- 409 コンフリクト - インポートまたはエクスポート・ジョブがすでに実行中であるか、ストレージ詳細が正しくないか、ファイルがすでに存在しています(上書きがfalseに設定されている場合)。
- 500 内部サーバー・エラー - レジストリまたはストレージとの通信中にエラーが発生しました。
次のコマンドを使用して、エクスポート操作のステータスを確認します:

GET
http://host:port/ic/api/common/v1/exportServiceInstanceArchive/{jobId}
ステータスがCompletedの場合、メタデータはオブジェクト・ストレージ・バケットに正常にエクスポートされました。
次に、メタデータをスタンバイ・インスタンスにインポートします。次のpostmanまたはcurlコマンドを使用してREST APIを起動します。

このアクションは、アーカイブが最初に作成されたOCI Object Storage Cloud Serviceバケット・インスタンスからアーカイブを取得します。

POST
http://host:port/ic/api/common/v1/importServiceInstanceArchive
リクエスト・ヘッダー:

Content-Type →application/json

リクエスト・ペイロード:
```
{    
          "archiveFile":"archive_Local_Suite_Instance-483.zip",    
          "importActivateMode":"importOnly",      // ImportOnly | ImportActivate |
          ActivateOnly | StartSchedulesOnly
          "importSecurityArtifacts":true,  
          "importAppRoleMembers":true,
          "importScheduleParams":true,    
          "startSchedules":false,
          "description":"Import to standby",    
          "storageName",   - name of storage configuration, this can be used instead of
           storageInfo, if both are defined storageInfo will take precedence    
          "storageInfo":{        
            "storageUrl":"https://swiftobjectstorage.us-ashburn-1.oraclecloud.com/v1/paasdevoic/<bucket
          name>",         
            "storageUser":"OCI cloud user name",        
            "storagePassword":”Auth password"     
              } 
          }
```
ノート:
importActivateMode変数をImportOnlyに設定すると、統合フローはインポートされますがアクティブ化されません。

レスポンス・ペイロード:
```
{ 
         "jobId": "457", "status": "NOT_STARTED"
         }
```
Response Status:
- 202 受入済 - エクスポート・ジョブが受け入れられました。
- 409 コンフリクト - インポートまたはエクスポート・ジョブがすでに実行中であるか、ストレージ詳細が正しくないか、ファイルがすでに存在しています(上書きがfalseに設定されている場合)。
- 500 内部サーバー・エラー - レジストリまたはストレージとの通信中にエラーが発生しました。
インポート・ステータスを確認します。

GET
https://host:port/ic/api/common/v1/importServiceInstanceArchive/457
ここで、457はインポート・レスポンス・ペイロードのジョブIDです。

ノート:
この例では、インポートされた統合はアクティブ化されず、ベスト・プラクティスに準拠しています。ただし、多くの統合がある場合は、インポート中にステートレス統合をアクティブ化できますが、スケジュール済、パブリッシュ/サブスクライブ、ポーリングまたはビジネス・イベントの統合はアクティブ化できません。