バンドルについて

バージョンとサイズの要件

• バンドルは、ソース環境とターゲット環境が同じバージョンであるか、ターゲットがソースよりも高いバージョンにある場合に機能します。
• バンドル・サイズは1 GB未満に保ちます。バンドルが1 GBを超える場合は、必要なアーティファクトのみを含めて分割します。サイズを確認する実用的な方法は、バンドルを生成してダウンロードすることです。

デプロイメント前の検証

デプロイメント前に、バンドルにはすべての前提条件が含まれていることが検証されます。検証に失敗すると、バンドルに「検証失敗」と表示され、問題を修正して再試行するまでデプロイできません。

バンドルを使用する理由

バンドルを使用して次のことを行います。

• 開発、テストまたは本番環境用のアーティファクトのサブセットをパッケージ化します。
• カスタム開発を別の環境に移行およびデプロイすること。
• 環境間で変更をプロモートして、環境を同期します。たとえば、本番環境からテスト環境などです。
• 問題のあとに環境を復元します(完全なシステム復元)。
• 環境のバックアップまたはアーティファクトのサブセットを作成します。
• バンドルをインポートして、特定のアーティファクトをリストアします。

バンドル・タイプ

• データ構成バンドルには次が含まれます:
  • パイプライン・パラメータ
  • 優先データセット
  • 機能領域アクティブ化メタデータ
  • データ拡張
  • カスタム・データ構成

  ノート:

  • データ・ウェアハウスをリセットした後にデプロイして、コンテンツを変更せずに保持し、データ・パイプライン構成を再確立できます。データ・ウェアハウスのリセットを参照してください。
  • デプロイ済の拡張または構成のみが含まれます。拡張またはソースにデプロイされていない構成は含まれません。
  • 接続の抽出構成は含めることができますが、接続の詳細は含めません。ターゲット環境には、必要な接続がすでに定義されている必要があります。

  データ共有機能を有効にした場合は、データ構成バンドルでデータ共有構成を選択できます。Oracle Cloud Infrastructure Object Storageへの接続の構成(プレビュー)を参照してください。

• セマンティック・モデル・バンドルには、次のようなセマンティック・モデルのすべてのカスタム・コンポーネントが含まれます:
  • 外部アプリケーション
  • システム拡張
  • ユーザー拡張機能
  • セキュリティ構成

  ノート:

  • 使用するセマンティック・モデル拡張フレームワークに応じて、バンドルにはメインのサンドボックスまたはブランチ、カスタムのサンドボックスまたはブランチとカスタム・コンポーネントが含まれます。ブランチ・フレームワークの場合、バンドルおよびデプロイするタグおよびバージョンを選択できます。
  • デプロイメントによって拡張がマージされ、置換されません。バンドルによって上書きされない場合は、ターゲット環境内の既存の拡張が残ります。
• セキュリティ・バンドルには次のものが含まれます:
  • グループからアプリケーション・ロールへの割当
  • カスタム・アプリケーション・役割
  • カスタム・データのセキュリティ
• コンテンツ・バンドルには、次のようなOracle Analytics Cloudコンテンツのスナップショットが含まれています:
  • フォルダ(データセットを除く)
  • プロジェクト
  • ワークブック
  • 主要なメトリック
  • 接続
  • 分析
  • コンテンツの職務ロール
  • レポート・パラメータ
  • カスタム・データ構成(構成可能な勘定科目分析など)

  ノート:

  • コンテンツ・バンドルでは、常にカタログ・コンテンツをソースからターゲットにマージします。
  • マージ中に競合が発生すると、競合する項目が置き換えられます。
  • 削除されたコンテンツ。トラッキングされません。
• コンポジット・バンドルには、他のバンドル・タイプの任意の組合せが含まれます。

  ノート:

  • コンポジット・バンドルを生成すると、コンポジット・バンドルとそれに含まれるバンドルが一緒に生成されます。
  • コンポジット・バンドルをインポートすると、コンポジット・バンドルと個々のバンドルの両方がインポートされます。
  • コンポジット・バンドルを全体としてデプロイするか、必要に応じて個々のバンドルをデプロイできます。たとえば、完全なコンポジット・バンドルを1つの環境にデプロイし、個別のバンドルを異なる環境にデプロイできます。
• 環境バンドルには次のものが含まれます:
  • セマンティック・モデル、セキュリティおよびコンテンツ・バンドルのすべて。
  • 他の場所ではカバーされていない追加の基本要素。

  環境バンドルをデプロイする前に、データ構成バンドルをデプロイするか、ターゲット環境でデータ・パイプラインをアクティブ化する必要があります。

• アプリケーション・バンドルには、次のものが含まれます:
  • コンテンツ・バンドル
  • (オプション)データ拡張スクリプトのカスタム・データ構成
  • セマンティック・モデルの拡張
  • セキュリティ・バンドル

  アプリケーション・バンドルには、Pipeline Builderで作成されたアプリケーション、および「カスタム・データ構成」ページで作成されたその他のパイプライン・アプリケーションが含まれます。アプリケーション・バンドルを使用すると、Pipeline Builder、外部セマンティック・モデル、事前構築済コンテンツおよびセキュリティ(JAZN)を含むコンポジット・バンドルを作成できます。

バンドル・デプロイメントの前提条件

セマンティック・モデルまたはコンテンツを操作する前に:

• 機能領域をアクティブ化し、データが使用可能であることを確認します。
• ターゲット環境で、構成およびアクティブ化がソース環境と同じレベルであることを確認するには、次のいずれかを実行します。
  • データ・パイプラインの手動構成およびアクティブ化
  • データ構成のバンドルのデプロイ

環境バンドル、セマンティック・モデル・バンドルまたはコンポジット・バンドルをデプロイするだけで済みます。これは、使用可能なデータに依存するためです。

推奨される方法

• セマンティック・モデルおよびコンテンツ・バンドルに適用可能なセキュリティ関連情報を含めます。
• セキュリティ・バンドルによってユーザー・グループ・マッピングが上書きされないため、デプロイメント後にユーザーにグループを再割当てします。
• セマンティック・モデル・バンドルをテストから本番にエクスポートする場合は、セキュリティ構成を含めます。
• セキュリティ・バンドルの作成中に、アプリケーション・ロールの数が1000を超えると、エラーが発生することがあります。そのような場合は、「アプリケーション・ロールの選択」ボタンを使用して特定のロールを選択します。
• セマンティック・モデル拡張ステップに一意の名前を使用して、セマンティック・モデル・バンドルを使用した移行時にタグが正しく機能するようにします。