Skip to main content
Astra Control Center
A newer release of this product is available.

Manage software packages

Contributors netapp-mwallis

NetApp delivers additional capabilities for Astra Control Center with software packages that you can download from the NetApp Support Site. After you connect Docker and artifact repositories, you can upload and import packages to add this functionality to Astra Control Center. You can use the CLI or the Astra Control Center web UI to manage software packages.

What you'll need
  • Kubernetes cluster with Astra Control Center installed

  • A connected Docker image repository to hold software package images. For more information, see Manage repository connections.

  • A connected artifact repository to hold software package binaries and artifacts. For more information, see Manage repository connections.

  • A software package from the NetApp Support Site

Upload software package images to the repositories

Astra Control Center references package images and artifacts in connected repositories. You can upload images and artifacts to the repositories using the CLI.

Steps
  1. Download the software package from the NetApp Support Site, and save it on a machine that has the kubectl utility installed.

  2. Extract the compressed package file, and change directory to the location of the Astra Control bundle file (for example, acc.manifest.yaml).

  3. Push the package images to the Docker repository. Make the following substitutions:

    • Replace BUNDLE_FILE with the name of the Astra Control bundle file (for example, acc.manifest.yaml).

    • Replace MY_REGISTRY with the URL of the Docker repository.

    • Replace MY_REGISTRY_USER with the user name.

    • Replace MY_REGISTRY_TOKEN with an authorized token for the registry.

      kubectl astra packages push-images -m BUNDLE_FILE -r MY_REGISTRY -u MY_REGISTRY_USER -p MY_REGISTRY_TOKEN
  4. If the package has artifacts, copy the artifacts to the artifact repository. Replace BUNDLE_FILE with the name of the Astra Control bundle file, and NETWORK_LOCATION with the network location to copy the artifact files to:

    kubectl astra packages copy-artifacts -m BUNDLE_FILE -n NETWORK_LOCATION

Add a software package

You can import software packages using an Astra Control Center bundle file. Doing this installs the package and makes the software available for Astra Control Center to use.

Add a software package using the Astra Control web UI

You can use the Astra Control Center web UI to add a software package that has been uploaded to the connected repositories.

Steps
  1. In the Manage Your Account navigation area, select Account.

  2. Select the Packages tab.

  3. Select the Add button.

  4. In the file selection dialog, select the upload icon.

  5. Choose an Astra Control bundle file, in .yaml format, to upload.

  6. Select Add.

Result

If the bundle file is valid and the package images and artifacts are located in your connected repositories, the package is added to Astra Control Center. When the status in the Status column changes to Available, you can use the package. You can hover over the status for a package to get more information.

Note If one or more images or artifacts for a package are not found in your repository, an error message appears for that package.

Add a software package using the CLI

You can use the CLI to import a software package that you have uploaded to the connected repositories. To do this, you first need to record your Astra Control Center account ID and an API token.

Steps
  1. Using a web browser, log in to the Astra Control Center web UI.

  2. From the Dashboard, select the user icon at the top right.

  3. Select API access.

  4. Note the Account ID near the top of the screen.

  5. Select Generate API token.

  6. In the resulting dialog, select Generate API token.

  7. Note the resulting token, and select Close.
    In the CLI, change directories to the location of the .yaml bundle file in the extracted package contents.

  8. Import the package using the bundle file, making the following substitutions:

    • Replace BUNDLE_FILE with the name of the Astra Control bundle file.

    • Replace SERVER with the DNS name of the Astra Control instance.

    • Replace ACCOUNT_ID and TOKEN with the account ID and API token you recorded earlier.

      kubectl astra packages import -m BUNDLE_FILE -u SERVER -a ACCOUNT_ID -k TOKEN
Result

If the bundle file is valid and the package images and artifacts are located in your connected repositories, the package is added to Astra Control Center.

Note If one or more images or artifacts for a package are not found in your repository, an error message appears for that package.

Remove a software package

You can use the Astra Control Center web UI to remove a software package that you previously imported in Astra Control Center.

Steps
  1. In the Manage Your Account navigation area, select Account.

  2. Select the Packages tab.

    You can see the list of installed packages and their statuses on this page.

  3. In the Actions column for the package, open the actions menu.

  4. Select Delete.

Result

The package is deleted from Astra Control Center, but the images and artifacts for the package remain in your repositories.

Find more information