アプリケーション・アーティファクトのバンドル
サービス管理者は、アプリケーション・アーティファクトのスナップショットをバンドルとして管理できます。
「LiveLabsスプリント: DVワークブックをテスト環境から本番環境に移行するにはどうすればよいですか。」
「LiveLabsスプリント: バンドルを使用して環境をバックアップおよびリストアするにはどうすればよいですか。」
「LiveLabsスプリント: セキュリティ・バンドルを作成およびデプロイするにはどうすればよいですか。」
バンドルについて
バンドルは、特定の時点での構成やカスタマイズなど、アプリケーション・アーティファクトのスナップショットです。
バンドルは、ソースとターゲットが同じレベルであるか、ソースが下位バージョンであり、ターゲットが上位バージョンである環境で機能します。 たとえば、以前のコンテンツ・バージョンから生成されたバンドルは、最新のコンテンツ・バージョンで機能します。 バンドル・サイズが1 GB未満であることを確認してください。 バンドル・サイズが1 GBを超える場合は、My Oracle Supportにサービス・リクエストを入力します。 デプロイメントの前に、バンドルがすべての前提条件を含んでいるかどうかがシステムによって検証されます。 検証エラーがある場合は、該当するバンドルが「検証失敗」ステータスで表示され、デプロイできません。 問題を修正し、再度デプロイする必要があります。
- 開発、テスト、本番などの環境内のアプリケーション・アーティファクトのサブセットを表すバンドルを定義して、カスタム開発をパッケージ化します。
- カスタム開発を移行し、ターゲット環境にバンドルをデプロイします。
- ある環境から別の環境(本番からテストなど)への変更をプロモートして、インスタンスを同期します。
- 環境に問題があり、完全なシステム・リストアを行う必要がある場合は、システムをリストアします。
- 環境またはアプリケーションのサブセットのバックアップを作成して、アーティファクトの現在の状態を保存します。
- バンドルからインポートしてアーティファクトをリストアし、関連するアーティファクトの状態をバンドル内のものにリストアします。
アプリケーション・アーティファクトは、次のようにバンドルできます:
- データ構成バンドル: これには、パイプライン・パラメータ、アクティブ化メタデータ、データ拡張およびカスタム・データ構成が含まれます。 このバンドルは、ハード・データのリセット後に既存の環境にインストールできます。 これは、コンテンツをそのままにしてデータ・パイプラインをリセットする場合に便利です。 データ構成をバンドルすると、デプロイされたデータ拡張または構成のみが含まれます。 ソース・インスタンスのデプロイ済状態ではない拡張または構成は、データ構成バンドルに含まれません。
- セマンティック・モデル・バンドル: これには、メイン・ブランチ、タグ、カスタム・ブランチおよびすべてのセキュリティ・カスタマイズが含まれます。
- セキュリティ・バンドル: これには、カスタム・アプリケーション・ロールとカスタム・データ・セキュリティが含まれます。
- コンテンツ・バンドル: これには、Oracle Analytics Cloudフォルダ、プロジェクト、データセット定義、ワークブック、コンテンツの職務ロールおよびレポート・パラメータのスナップショットが含まれます。 コンテンツ・バンドルは、常にカタログ・コンテンツをソースからターゲットにマージします。 マージ中に競合が見つかった場合は、コンテンツが置換されます。 削除されたコンテンツはトラッキングされません。
- コンポジット・バンドル: これには、他のバンドルが1つ以上含まれます。
- 環境バンドル: これには、システムの既知の状態に戻す特定の環境のすべてのアーティファクトが含まれます。 たとえば、サービス管理者は毎週末にDevEnv_YYMMDDというバンドルを作成して、環境のバックアップを保持できます。 環境バンドルをデプロイする前に、まずデータ構成バンドルをデプロイするか、データ・パイプラインを手動でアクティブ化する必要があります。
ノート:
セマンティック・モデルまたはコンテンツを操作する前に、機能領域とデータをアクティブ化したことを確認します。 ターゲット環境でデータ・パイプラインを手動で構成およびアクティブ化するか、データ構成バンドルをデプロイして、構成およびアクティブ化がソース環境と同じレベルであることを確認します。 その場合のみ、環境バンドル、セマンティック・バンドルまたはコンポジット・バンドルはデータに依存するため、デプロイするのが適切です。- セマンティック・モデルおよびコンテンツ・バンドルに適用可能なセキュリティ関連情報を含めます。
- セキュリティ・バンドルによってユーザー・グループ・マッピングが上書きされないため、ユーザーにグループを再割当てします。
- テスト環境から本番環境にセマンティック・モデル・バンドルをエクスポートする場合は、セキュリティ構成を含めます。
- セマンティック・モデル拡張ステップに一意の名前を使用します。 これにより、コンテンツ・バンドルを使用してコンテンツをターゲット・インスタンスに移行する際に、タグを正しく動作させることができます。
バンドルで利用可能なもの
バンドルで利用できるものについて学習します。
| 領域 | アーティファクト | バンドルに含まれる |
|---|---|---|
| セキュリティ | アプリケーション・ロール | セキュリティと環境 |
| セキュリティ | ユーザーとグループ | いいえ - 手動移動(Identity Cloud Serviceで実行) |
| セキュリティ | グループからロールへの割当 | セキュリティと環境 |
| セキュリティ | 構成可能なコンテキストを含むセキュリティ・コンテキスト | いいえ - 手動で移動 |
| アップロードされたファイル | 財務カテゴリ、セキュリティ割当 | いいえ - 手動で移動 |
| システム設定 | プレビュー機能を含むOracle Analytics Cloudシステム設定 | いいえ - ターゲット環境で手動で作成 |
| 機能の有効化 | アクティブ化されたOracle Fusion Data Intelligence機能 | いいえ - ターゲット環境で手動で作成 |
| セマンティック・モデル拡張 | システム、ユーザー、セキュリティ構成 | セマンティックおよび環境 |
| データ検証 | AP請求書などのスケジュール済検証(週次) | いいえ - ターゲット環境で手動で作成 |
| Oracle Analytics Cloudコンテンツ | ||
| 主要指標、ワークブック、接続、分析 | コンテンツと環境 | |
| データ・フロー、関数、機械学習アプリケーション | 環境 | |
| キー・メトリック | いいえ - サービス・リクエストを作成 | |
| データセット | いいえ - 手動で移動 | |
| レポート構成 | 基本的なレポート構成 | コンテンツ |
| レポート構成 | 高度な(構成可能な勘定科目分析) | いいえ - ターゲット環境で手動で作成 |
| データ・パイプライン | パイプライン・パラメータ、機能領域、拡張 | データ構成 |
| データ・パイプライン | 頻繁なリフレッシュ・モジュール、表、優先リフレッシュ | いいえ - ターゲット環境で手動で作成 |
| データ・パイプライン | 倉庫の全リロード・スケジュール | いいえ - ターゲット環境で手動で作成 |
| データ・パイプライン | カスタム・データ構成 - DFF、構成可能な勘定科目分析などのカスタム・アプリケーション | いいえ - ターゲット環境で手動で作成 |
| 接続 | データ拡張コネクタ | いいえ - ターゲット環境で手動で作成 |
| Oracle Cloud Infrastructureコンソール設定 | 権限、接続、PaaSコンポーネント設定 | いいえ - ターゲット環境で手動で作成 |
| Oracle Autonomous Data Warehouseカスタム・スキーマ | OAX_USERスキーマ・オブジェクトおよびデータ | いいえ - データ・ポンプを使用したOracle Object Storage Serviceへのバックアップとリストア |
バンドルの作成
アプリケーション・アーティファクトのスナップショットを作成して、現在の状態を保存します。 「バンドル」ページで作成したバンドルを表示できます。
ソース・インスタンスでバンドルを作成する際は、ターゲット・インスタンスでも使用できるデータ・ソースのみを選択して、ターゲット・インスタンスでのデプロイメントの失敗を回避してください。
コンテンツ・バンドルを作成および生成する前に、どのデータセットにも特殊文字を含む名前がないことを確認してください。 また、一部のデータセットにバックアップする主要メトリックがない場合は、それぞれのサブジェクト領域とデータセットから主要メトリックを手動で選択し、コンテンツ・バンドルを再生成します。 バンドルにバックアップするキー・メトリックがない場合は、ユーザー・インタフェースから「OACコンテンツ」オプションのみを選択できます。
- 「バンドル」ページで、「作成」をクリックします。
- 「バンドルの作成」で、作成するバンドルのタイプを選択します。 たとえば、コンテンツ・バンドルです。
- バンドルのタイプに応じて、該当するオプションを選択し、保存をクリックします:
- コンテンツ・バンドルの場合は、「すべてのコンテンツを含める」チェック・ボックスを選択するか、対応するトグルとボタンを使用して、該当するOracle Analytics Cloudコンテンツ、ワークブックおよびキー・メトリックを選択します。 「ユーザー・セキュリティを含める」および「レポート・パラメータを含める」チェック・ボックスを選択できます。
- 主要なメトリック・コンテンツ・バンドルの場合は、対応する切替えおよびボタンを使用して、バンドルするキー・メトリックを選択します。 主要なメトリックは、環境バンドルにも含まれています。 パフォーマンスを向上させるには、バンドルする特定のキー・メトリックを選択します。
ノート:
キー・メトリックをインポートするには、キー・メトリックが有効になっている新しいインスタンスにキー・メトリック・バンドルをデプロイする必要があります。 データセットにキー・メトリックをインポートできますが、セキュリティの制限によりデータセット全体がインポートされません。 主要メトリックのないデータセットは、主要メトリックには含まれません。 - データ構成バンドルの場合は、「すべてのデータ構成設定を含める」チェック・ボックスを選択するか、該当するモジュール、拡張およびカスタム・データ構成を、対応するトグルおよびボタンを使用して選択します。
- セマンティック拡張バンドルの場合は、「すべてのセマンティック拡張を含める」チェック・ボックスを選択するか、「ターゲット環境でのブランチまたはタグの公開」フィールドで該当するブランチまたはタグを選択するか、対応するトグルとボタンを使用して該当するタグおよびブランチを選択します。 「外部RPDを含める」または「外部RPDの公開」チェック・ボックスを選択して、外部セマンティック・モデルを含めるか公開できます。
セマンティック・モデルを拡張するための最新のウィザードに移行した場合は、該当する外部アプリケーションを選択し、「セマンティック拡張」チェック・ボックスを選択してすべての拡張機能を含めます。
- セキュリティ・バンドルの場合は、「すべてのセキュリティ設定を含める」チェック・ボックスを選択して、トグルとボタンを使用してアプリケーション・ロールを選択します。
ノート:
Oracle Fusion Data Intelligenceの強化されたセキュリティ機能を利用した場合、セキュリティ・バンドルの一部としてグループを明確に選択できなくなります。 「ユーザー、グループ、アプリケーション・ロールおよびデータ・アクセスの管理について」を参照してください。 - 環境バンドルの場合は、名前を指定します。
- コンポジット・バンドルの場合は、他のバンドルのいずれかを選択します。
- コンテンツ・バンドルの場合は、「すべてのコンテンツを含める」チェック・ボックスを選択するか、対応するトグルとボタンを使用して、該当するOracle Analytics Cloudコンテンツ、ワークブックおよびキー・メトリックを選択します。 「ユーザー・セキュリティを含める」および「レポート・パラメータを含める」チェック・ボックスを選択できます。
バンドルの公開
ソース環境からバンドルを公開します。 このアクションは、アプリケーション・アーティファクトのスナップショットを生成し、スナップショットをリポジトリに保存します。 このバンドルされたアーティファクトをダウンロードして、別のインスタンスにインポートできます。
- 「処理」から、「生成」を選択してバンドルを作成および公開します。
バンドルのインポート
バンドル.aabファイルをコンピュータからターゲット環境にインポートして、アプリケーションの状態をバンドルによって表されるチェックポイントにリストアします。
- 「バンドル」ページで、「インポート」をクリックします。
- 「バンドルのインポート」ダイアログで、「ドラッグ・アンド・ドロップ」をクリックし、ローカル・マシンから該当する.aabファイルを選択します。
バンドルのデプロイ
生成されたバンドルをターゲット環境にデプロイして、バンドルによって表されるアーティファクトの状態に戻すことができます。 デプロイメントを試行する前にバンドルが検証され、ソフトウェアとモデルのバージョンおよびその他の依存関係が満たされていることが確認されます。
- 「処理」から、「デプロイ」を選択します。
バンドルのアクティビティ履歴の表示
バンドル関連のすべてのアクティビティを表示して、インスタンスに加えられた変更、使用するバンドル、および既存のバンドルがまだ最新かどうかを把握します。 この情報により、更新されたバンドルの作成または既存のバンドルのデプロイについて情報に基づいたディシジョンを行うことができます。
- 「バンドル」ページで、「アクティビティ」タブをクリックします。
