Bundle Your Application Artifacts

As a service administrator, you can manage snapshots of your application artifacts as bundles.

Topics:

• About Bundles
• Create a Bundle
• Edit a Bundle
• Publish a Bundle
• Deploy a Bundle
• Export a Bundle
• Import a Bundle
• Delete a Bundle

About Bundles

Bundles are snapshots of your application artifacts at a certain point in time.

Bundles enable you to:

• Package custom development by defining a bundle that represents a subset of app artifacts in an environment. For example, development, test, or production.
• Migrate custom development and deploy the bundle on a target environment.
• Synchronize instances by making a replica or promote changes from the target to the source environment. For example, production to test.
• Restore the system when something goes wrong with an environment and you need to do a complete system restore.
• Create a backup at a checkpoint of the environment or subset of application to save current state of the artifacts.
• Restore artifacts by importing from a bundle to restore state of application to the checkpoint represented by the bundle.

You can bundle your application artifacts as:

• Data Config bundle: This includes pipeline parameters, report parameters, activation metadata, and data augmentations. You can install this bundle in an existing environment after a hard data reset. This is useful to leave content as-is and reset data pipeline.
• Semantic Model bundle: This includes main branch, tags, custom branch, duty and data roles for semantic extension.
• Security bundle: This includes custom groups, application roles, and custom security.
• Content bundle: This includes snapshots of Oracle Analytics Cloud folders, projects, dataset definitions, KPIs, decks, and duty roles for content.
• Composite bundle: This includes one or more of the other bundles.
• Environment bundle: This includes all artifacts of a specific environment to revert to a known state of system. For example, at the end of every week, the service administrator can create a bundle called DevEnv_YYMMDD to maintain a backup of the environment. You must first deploy the data configuration bundle or manually activate your data pipelines before deploying the environment bundle.

Create a Bundle

Create a snapsnot of your application artifacts to save their current state.

1. Sign in to your service.
2. In Oracle Fusion Analytics Warehouse, open the Navigator menu, click Console, and then click Bundles under Application Administration.
   You see the Bundles page.
3. On the Bundles page, click Create and select the type of bundle that you want to create. For example, Content Bundle.
4. Enter a name and description for your bundle.
5. Perform these actions:
   • For a content bundle, do either of the following and click Save:
     1. Select the Include All Content check box.
     2. Select applicable OAC content, decks, and KPIs using the corresponding toggles and buttons.
   • For a data config bundle, do either of the following and click Save:
     1. Select the Include all data configuration settings check box.
     2. Select applicable modules and augmentations using the corresponding toggles and buttons.
   • For a semantic extensions bundle, do either of the following and click Save:
     1. Select the Include all semantic extensions check box.
     2. Select the Publish a branch or tag in the target environment check box and select the applicable option from the dropdown list.
     3. Select applicable tags and branches using the corresponding toggles and buttons.
   • For a security bundle, do either of the following and click Save:
     1. Select the Include all security settings check box.
     2. Select applicable groups and application roles using the corresponding toggles and buttons.
   • For a an environment bundle, select the Include groups check box, if required, and click Save.
   • For a composite bundle, select any of the other bundles, and click Save.

You see the bundles that you created on the Bundles page.

Edit a Bundle

Edit a bundle if you need to change the application artifacts captured in the bundle.

1. Sign in to your service.
2. In Oracle Fusion Analytics Warehouse, open the Navigator menu, click Console, and then click Bundles under Application Administration.
   You see the Bundles page.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Edit.
5. On the applicable bundles page, make your changes and then click Update.
   You must regenerate the bundle.

Publish a Bundle

Publish a bundle from the source environment. This action generates a snapshot of the application artifacts and saves the snapshot to a repository.

1. Sign in to your service.
2. In Oracle Fusion Analytics Warehouse, open the Navigator menu, click Console, and then click Bundles under Application Administration.
   You see the Bundles page.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Generate to create and publish the bundle.

You see the bundle with Generated status on the Bundles page.

Deploy a Bundle

You can deploy a generated bundle in the target environment to revert to state of artifacts represented by the bundle. The application validates the bundle before attempting any deployment to ensure software and model versions and any other dependencies are met.

1. Sign in to your service.
2. In Oracle Fusion Analytics Warehouse, open the Navigator menu, click Console, and then click Bundles under Application Administration.
   You see the Bundles page.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Deploy.
5. In the Deploy Bundle dialog, ensure that you see the bundle that you have selected.
6. Click Deploy.

Export a Bundle

Export the bundle .aab file from your source system to a repository or your local machine.

1. Sign in to your service.
2. In Oracle Fusion Analytics Warehouse, open the Navigator menu, click Console, and then click Bundles under Application Administration.
   You see the Bundles page.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Export.

Import a Bundle

Import the bundle .aab file into the target environment from your local machine to restore the state of the application to the checkpoint represented by the bundle.

1. Sign in to your service.
2. In Oracle Fusion Analytics Warehouse, open the Navigator menu, click Console, and then click Bundles under Application Administration.
   You see the Bundles page.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Import.
5. In the Import Bundle dialog, click in Drag and Drop, and then select the applicable .aab file from your local machine.
6. Click Import.

Delete a Bundle

Delete a bundle if you no longer require the snapshot of your application artifacts captured in the bundle.

1. Sign in to your service.
2. In Oracle Fusion Analytics Warehouse, open the Navigator menu, click Console, and then click Bundles under Application Administration.
   You see the Bundles page.
3. On the Bundles page, hover over the bundle that you created and click under Actions.
4. From Actions, select Delete.