アプリケーション・アーティファクトのバンドル

サービス管理者は、アプリケーション・アーティファクトのスナップショットをバンドルとして管理できます。

「チュートリアル」アイコン LiveLabsスプリント: DVワークブックをテスト環境から本番環境に移行するにはどうすればよいですか。

「チュートリアル」アイコン LiveLabsスプリント: バンドルを使用して環境をバックアップおよびリストアするにはどうすればよいですか。

「チュートリアル」アイコン LiveLabsスプリント: セキュリティ・バンドルを作成およびデプロイするにはどうすればよいですか。

「チュートリアル」アイコン LiveLabsスプリント: コンテンツ・バンドルを生成するにはどのようにするのですか。

「チュートリアル」アイコン LiveLabsスプリント: セマンティック・モデル・バンドルを作成およびデプロイするにはどうすればよいですか。

バンドルについて

バンドルは、特定の時点での構成やカスタマイズなどのアプリケーション・アーティファクトのスナップショットです。

バンドルは、ソースとターゲットが同じレベルであるか、ソースが下位バージョンであり、ターゲットが上位バージョンである環境で機能します。たとえば、以前のコンテンツ・バージョンから生成されたバンドルは、最新のコンテンツ・バージョンで動作します。バンドル・サイズが1 GB未満であることを確認してください。バンドル・サイズが1GBを超える場合は、必要なアーティファクトを選択してバンドルを分割することを検討してください。デプロイメントの前に、バンドルがすべての前提条件を含んでいるかどうかがシステムによって検証されます。検証エラーがある場合は、該当するバンドルが「検証失敗」ステータスで表示され、デプロイできません。問題を修正し、再度デプロイする必要があります。

バンドルを使用すると、次のことができます。
  • 開発、テスト、本番などの環境内のアプリケーション・アーティファクトのサブセットを表すバンドルを定義して、カスタム開発をパッケージ化します。
  • カスタム開発を移行し、バンドルをターゲット環境にデプロイします。
  • ある環境から別の環境(本番からテストなど)への変更を昇格して、インスタンスを同期します。
  • 環境に問題があり、完全なシステム復元を行う必要がある場合は、システムを復元します。
  • アーティファクトの現在の状態を保存するために、環境のバックアップまたはアプリケーションのサブセットを作成します。
  • バンドルからインポートしてアーティファクトをリストアし、関連するアーティファクトの状態をバンドル内の状態に戻します。

次のようにアプリケーション・アーティファクトをバンドルできます:

  • データ構成バンドル: パイプライン・パラメータ、アクティブ化メタデータ、データ拡張およびカスタム・データ構成が含まれます。このバンドルは、ハード・データのリセット後に既存の環境にインストールできます。これは、コンテンツをそのままにして、データ・パイプラインをリセットする場合に便利です。データ構成をバンドルすると、デプロイされたデータ拡張または構成のみが含まれます。ソース・インスタンスのデプロイ済状態ではない拡張または構成は、データ構成バンドルに含まれません。
  • セマンティック・モデル・バンドル: これには、メイン・ブランチ、タグ、カスタム・ブランチおよびすべてのセキュリティ・カスタマイズが含まれます。このバンドルを使用してセマンティック・モデル拡張をインポートします。これは、公開するタグとバージョンおよび公開対象を選択できるためです。
  • セキュリティ・バンドル: これには、カスタム・アプリケーション・ロールとカスタム・データ・セキュリティが含まれます。
  • コンテンツ・バンドル: これには、Oracle Analytics Cloudフォルダ、プロジェクト、データセット定義、ワークブック、コンテンツの職務ロールおよびレポート・パラメータのスナップショットが含まれます。コンテンツ・バンドルでは、カタログ・コンテンツが常にソースからターゲットにマージされます。マージ中に競合が見つかった場合は、コンテンツが置き換えられます。削除されたコンテンツは追跡されません。
  • コンポジット・バンドル: これには、他の1つ以上のバンドルが含まれます。
  • 環境バンドル: 環境バンドルは、カスタマイズなしで元のセマンティック・モデルを公開します。これには、システムの既知の状態に戻す特定の環境のすべてのアーティファクトが含まれます。たとえば、毎週の終わりに、サービス管理者はDevEnv_YYMMDDというバンドルを作成して、環境のバックアップを維持できます。環境バンドルをデプロイする前に、まずデータ構成バンドルをデプロイするか、データ・パイプラインを手動でアクティブ化する必要があります。
ノート

セマンティック・モデルまたはコンテンツを操作する前に、機能領域をアクティブ化し、データが使用可能であることを確認してください。ターゲット環境でデータ・パイプラインを手動で構成およびアクティブ化するか、データ構成バンドルをデプロイして、構成およびアクティブ化がソース環境と同じレベルになるようにします。その場合のみ、環境バンドル、セマンティック・バンドルまたはコンポジット・バンドルはデータに依存するため、デプロイするのが適切です。
スムーズなエクスペリエンスを実現するには、次の推奨プラクティスに従います。
  • セマンティック・モデルおよびコンテンツ・バンドルに適用可能なセキュリティ関連情報を含めます。
  • セキュリティ・バンドルはユーザー・グループ・マッピングを上書きしないため、ユーザーにグループを再割当てします。
  • テスト環境から本番環境にセマンティック・モデル・バンドルをエクスポートする場合は、セキュリティ構成を含めます。
  • セキュリティ・バンドルの作成中に、アプリケーション・ロールの数が1000を超えると、エラーが発生することがあります。このような場合は、「アプリケーション・ロールの選択」ボタンを使用して特定のロールを選択します。
  • セマンティック・モデル拡張ステップに一意の名前を使用します。これにより、コンテンツ・バンドルを使用してコンテンツをターゲット・インスタンスに移行する際に、タグを正しく動作させることができます。

バンドルで使用可能なもの

バンドルで使用可能な内容を確認します。

アーティファクト バンドルに含む
セキュリティ アプリケーション・ロール セキュリティと環境
セキュリティ ユーザーとグループ いいえ – 手動で移動します。Identity Cloud Serviceで実行されます
セキュリティ グループからロールへの割当て セキュリティと環境
セキュリティ 構成可能なコンテキストを含むセキュリティ・コンテキスト いいえ- 手動で移動します
アップロード済ファイル 財務カテゴリ、セキュリティ割当 いいえ- 手動で移動します
システム設定 プレビュー機能を含むOracle Analytics Cloudシステム設定 いいえ – ターゲット環境で手動で作成します。
機能の有効化 Oracle Fusion Data Intelligenceのアクティブ化機能 いいえ – ターゲット環境で手動で作成します。
セマンティック・モデル拡張 システム、ユーザー、セキュリティ構成 セマンティックと環境
データ検証 AP請求書、週次などのスケジュール済検証 いいえ – ターゲット環境で手動で作成します。
Oracle Analytics Cloudコンテンツ    
主要なメトリック、ワークブック、接続、分析 コンテンツと環境  
データ・フロー、機能、機械学習アプリケーション 環境  
主要なメトリック いいえ – サービス・リクエストを作成します  
データセット いいえ- 手動で移動します  
レポート構成 基本レポート構成 コンテンツ
レポート構成 拡張(構成可能な勘定科目分析) いいえ – ターゲット環境で手動で作成します。
データ・パイプライン パイプライン・パラメータ、機能領域、拡張 データ構成
データ・パイプライン 頻繁なリフレッシュ・モジュール、表、優先リフレッシュ いいえ – ターゲット環境で手動で作成します。
データ・パイプライン ウェアハウス・フルロード・スケジュール いいえ – ターゲット環境で手動で作成します。
データ・パイプライン カスタム・データ構成 –DFF、構成可能な勘定科目分析などのカスタム・アプリケーション いいえ – ターゲット環境で手動で作成します。
接続数 データ拡張コネクタ いいえ – ターゲット環境で手動で作成します。
Oracle Cloud Infrastructure Consoleの設定 権限、接続、PaaSコンポーネント設定 いいえ – ターゲット環境で手動で作成します。
Oracle Autonomous Data Warehouseカスタム・スキーマ OAX_USERスキーマ・オブジェクトおよびデータ いいえ – データ・ポンプを使用して、Oracle Object Storage Serviceへのバックアップとリストアを行います

バンドルの作成

アプリケーション・アーティファクトのスナップショットを作成して、現在の状態を保存します。「バンドル」ページで作成したバンドルを表示できます。

ソース・インスタンスにバンドルを作成する際は、ターゲット・インスタンスでデプロイメントの失敗を回避するために、ターゲット・インスタンスでも使用可能なデータ・ソースのみを選択してください。

アプリケーション・バンドルの場合は、このオプションを使用可能にするためにサービス・リクエストを発行してください。次に、「機能を有効化」ページの「プレビュー」タブからアプリケーション・バンドル機能を有効にします。

コンテンツ・バンドルを作成および生成する前に、どのデータセットにも特殊文字を含む名前がないことを確認してください。また、一部のデータセットにバックアップする主要メトリックがない場合は、それぞれのサブジェクト領域とデータセットから主要メトリックを手動で選択し、コンテンツ・バンドルを再生成します。バンドルにバックアップするキー・メトリックがない場合は、ユーザー・インタフェースから「OACコンテンツ」オプションのみを選択できます。

  1. サービスにサインインします。
  2. Oracle Fusion Data Intelligenceコンソールで、「アプリケーション管理」の下の「バンドル」をクリックします。
  3. 「バンドル」ページで、「作成」をクリックします。

    fawag_bundles_create.pngの説明が続きます

  4. 「バンドルの作成」で、作成するバンドルのタイプを選択します。たとえば、コンテンツ・バンドルなどです。

    fawag_create_bundle.pngの説明が続きます

  5. バンドルの名前と摘要を入力します。
  6. バンドルのタイプに応じて、該当するオプションを選択し、「保存」をクリックします:
    • コンテンツ・バンドルの場合は、「すべてのコンテンツを含める」チェック・ボックスを選択するか、対応するトグルとボタンを使用して、該当するOracle Analytics Cloudコンテンツ、ワークブックおよびキー・メトリックを選択します。必要に応じて、「レポート・パラメータを含める」および「構成可能な勘定科目分析を含める」チェック・ボックスを選択できます。
      fawag_content_bundle.pngの説明が続きます

    • 主要なメトリック・コンテンツ・バンドルの場合は、対応する切替えおよびボタンを使用して、バンドルするキー・メトリックを選択します。主要なメトリックは、環境バンドルにも含まれています。パフォーマンスを向上させるには、バンドルする特定のキー・メトリックを選択します。

      「コンテンツ・バンドル」ページの主要なメトリック

      ノート

      キー・メトリックをインポートするには、キー・メトリックが有効になっている新しいインスタンスにキー・メトリック・バンドルをデプロイする必要があります。データセットにキー・メトリックをインポートできますが、セキュリティの制限によりデータセット全体がインポートされません。主要メトリックのないデータセットは、主要メトリックには含まれません。
    • データ構成バンドルの場合は、「すべてのデータ構成設定を含める」チェック・ボックスを選択するか、該当するモジュール、拡張およびカスタム・データ構成を対応するトグルおよびボタンを使用して選択します。
      fawag_data_config_bundle.pngの説明が続きます

    • セマンティック拡張バンドルの場合は、「すべてのセマンティック拡張を含める」チェック・ボックスを選択するか、「ターゲット環境でのブランチまたはタグの公開」フィールドで該当するブランチまたはタグを選択するか、対応するトグルおよびボタンを使用して該当するタグおよびブランチを選択します。「外部RPDを含める」または「外部RPDの公開」チェック・ボックスを選択して、外部セマンティク・モデルを追加または公開できます。
      fawag_semantic_extensions_bundle.pngの説明が続きます

      セマンティック・モデルを拡張するための最新のウィザードに移行した場合は、該当する外部アプリケーションを選択し、「セマンティック拡張」チェック・ボックスを選択してすべての拡張機能を含めます。
      最新のセマンティック・モデル拡張ウィザードに移行した場合は、「セマンティック拡張バンドル」ページ

    • セキュリティ・バンドルの場合は、「すべてのセキュリティ設定を含める」チェック・ボックスを選択するか、すべてのアプリケーション・ロールを選択します。アプリケーション・ロールの数が1000を超えると、エラーが発生する可能性があります。このような場合は、「アプリケーション・ロールの選択」ボタンを使用して特定のロールを選択します。
      ノート

      Oracle Fusion Data Intelligenceの拡張セキュリティ機能を更新した場合は、セキュリティ・バンドルの一部としてグループを明示的に選択できなくなります。ユーザー、グループ、アプリケーション・ロールおよびデータ・アクセスの管理についてを参照してください。

      fawag_security_bundle.pngの説明が続きます

    • 環境バンドルの場合は、名前を指定します。
      fawag_environment_bundle.pngの説明が続きます

    • コンポジット・バンドルの場合は、他のバンドルのいずれかを選択します。
      fawag_composite_bundle.pngの説明が続きます

バンドルの編集

バンドルに取得されたアプリケーション・アーティファクトを変更する必要がある場合は、バンドルを編集します。

  1. サービスにサインインします。
  2. Oracle Fusion Data Intelligenceコンソールで、「アプリケーション管理」の下の「バンドル」をクリックします。
  3. 「バンドル」ページで、作成したバンドルにマウス・ポインタを重ねて、「アクション」をクリックします。
  4. 「アクション」から、「編集」を選択します。

    fawag_bundles_actions_edit.pngの説明が続きます

  5. 該当するバンドル・ページで変更を行い、「更新」をクリックします。

バンドルの公開

ソース環境からバンドルを公開します。このアクションは、アプリケーション・アーティファクトのスナップショットを生成し、スナップショットをリポジトリに保存します。このバンドルされたアーティファクトをダウンロードして、別のインスタンスにインポートできます。

  1. サービスにサインインします。
  2. Oracle Fusion Data Intelligenceコンソールで、「アプリケーション管理」の下の「バンドル」をクリックします。
  3. 「バンドル」ページで、作成したバンドルにマウス・ポインタを重ねて、「アクション」をクリックします。
  4. 「アクション」から、「生成」を選択してバンドルを作成および公開します。

    fawag_bundles_actions_generate.pngの説明が続きます

「バンドル」ページに「生成済」ステータスのバンドルが表示されます。

バンドルのエクスポート

バンドル.aabファイルをソース・システムからリポジトリまたはローカル・マシンにエクスポートします。

  1. サービスにサインインします。
  2. Oracle Fusion Data Intelligenceコンソールで、「アプリケーション管理」の下の「バンドル」をクリックします。
  3. 「バンドル」ページで、作成したバンドルにマウス・ポインタを重ねて、「アクション」をクリックします。
  4. 「アクション」で、「エクスポート」を選択します。

    fawag_bundles_actions_export.pngの説明が続きます

バンドルのインポート

バンドル.aabファイルをコンピュータからターゲット環境にインポートして、アプリケーションの状態をバンドルによって表されるチェックポイントにリストアします。

  1. サービスにサインインします。
  2. Oracle Fusion Data Intelligenceコンソールで、「アプリケーション管理」の下の「バンドル」をクリックします。
  3. 「バンドル」ページで、「インポート」をクリックします。

    fawag_bundles_import_option.pngの説明が続きます

  4. 「バンドルのインポート」ダイアログで、「ドラッグ・アンド・ドロップ」をクリックし、ローカル・マシンから該当する.aabファイルを選択します。

    fawag_import_bundle.pngの説明が続きます

  5. 「インポート」をクリックします。

バンドルのデプロイ

生成されたバンドルをターゲット環境にデプロイして、バンドルによって表されるアーティファクトの状態に戻すことができます。デプロイメントを試行する前にバンドルが検証され、ソフトウェアとモデルのバージョンおよびその他の依存関係が満たされていることが確認されます。

たとえば、バンドルA (インスタンスAで作成)があり、後で変更を加えたが、それらの変更を元に戻す場合は、「デプロイ」オプションを使用します。このオプションは、システムに前のバンドルをデプロイすることで、アーティファクトを古いバージョンにリストアします。
  1. サービスにサインインします。
  2. Oracle Fusion Data Intelligenceコンソールで、「アプリケーション管理」の下の「バンドル」をクリックします。
  3. 「バンドル」ページで、作成したバンドルにマウス・ポインタを重ねて、「アクション」をクリックします。
  4. 「アクション」から、「デプロイ」を選択します。

    fawag_bundles_actions_deploy.pngの説明が続きます

  5. 「バンドルのデプロイ」ダイアログで、選択したバンドルが表示されていることを確認します。
  6. 「デプロイ」をクリックします

バンドルの削除

バンドルに取得されたアプリケーション・アーティファクトのスナップショットが不要になった場合は、バンドルを削除します。

  1. サービスにサインインします。
  2. Oracle Fusion Data Intelligenceコンソールで、「アプリケーション管理」の下の「バンドル」をクリックします。
  3. 「バンドル」ページで、作成したバンドルにマウス・ポインタを重ねて、「アクション」をクリックします。
  4. 「アクション」から、「削除」を選択します。

    fawag_bundles_actions_delete.pngの説明が続きます

バンドルのアクティビティ履歴の表示

バンドル関連アクティビティをすべて表示して、インスタンスに加えられた変更、使用するバンドル、および既存のバンドルがまだ最新かどうかを把握します。この情報により、更新されたバンドルの作成または既存のバンドルのデプロイについて情報に基づいた決定を行うことができます。

すべてのアクティビティが、バンドル関連アクション、バンドル名、バンドル・タイプ、ステータス、アクティビティを実行したユーザー、および日付別に表示されます。表示は、列のソート、アクティビティの検索、およびアクション、バンドル・タイプまたはステータスによるフィルタリングによって編成できます。
  1. サービスにサインインします。
  2. Oracle Fusion Data Intelligenceコンソールで、「アプリケーション管理」の下の「バンドル」をクリックします。
  3. 「バンドル」ページで、「アクティビティ」タブをクリックします。

    「バンドル」ページの「アクティビティ」タブ