Search documentation
karat

+

K

Guidelines for exporting and importing data in Apollo

This policy outlines the types of data that you can export from an Apollo Hub and import to other Apollo Hubs.

Resources you cannot export or import

Hub settings and configuration

The settings for your Apollo Hub are core to its security, compliance, and operational health. You are unable to export fields that are configured in the Settings & Configuration page in Apollo and import them to another Hub.

Hub settings must be set up by default through Apollo services, or by an administrator on Target Hub initialization. This will ensure that Target Hub administrators can view and understand what settings will not tampered with by the import process.

Permissions

You cannot export or import role grants for resources, changes to resource ownership, or changes to membership of a Team or Group. Permissions for a Target Hub must be set up from that Hub.

Resources you can export or import

The following items will be exported without settings or permissions. After importing the Bundle, you will need to configure these missing settings from the Target Hub.

Apollo resources

You can export and import resources that non-administrator users create, modify, or interact with on a regular basis. This includes new Product Releases, Products, and so forth.

Kubernetes namespaces

You can export and import Apollo-managed K8s Namespaces on an Environment. Note that if you are exporting a K8s Namespace with the privileged feature enabled, it will be imported as a regular, non-privileged K8s Namespace. After import, you will be able to open a Change Request to mark the imported K8s Namespace as privileged again. This ensures that any privileged K8s Namespaces have been approved on the Hub in which they are running, even if they were imported from another Hub.

Release Channels

Release Channels can be exported and imported as Apollo resources. Product Release metadata separately records the Release Channels to which a Product Release belongs.

Release Channel export

Release Channels are selected through Environment, Module, or Product selectors. Environment selectors include the Release Channels used by the selected Environments. Module and Product selectors include Release Channels referenced by their inclusion filters.

Only Release Channels configured as exportable under Hub Settings > Release Channels are included in a Bundle. A non-exportable Release Channel can still be used to select Product Releases, but Apollo will not export the Release Channel resource or include the Release Channel in the exported Product Release metadata.

Release Channel import

When a Bundle contains a Release Channel, Apollo automatically creates it on the Target Hub if it does not already exist. You do not need to manually create custom Release Channels before importing Product Releases.

An imported Product Release is only added to an existing Release Channel if it satisfies that Release Channel's label requirements.