Private Regions

The Private Regions tab provides a central location where you can view, manage, and make requests for Datacenters to be added to your Private Regions. The Private Regions tab only shows Datacenters in your own regions. You can use the Private Regions tab to manage which environments your Datacenters are located in. This tab also provides the ability to download files from Datacenters in your private regions so you can deploy the Mission Control Agent into a Kubernetes cluster in your own Customer-Controlled Region with provided instructions.

You can perform the following task for environments:

About Private Regions

If you don't have any Datacenters in your private regions, you see a screen stating that no Datacenters are available.

On this screen you can click Request New Datacenter to open a form where you can make a request to add Datacenters to your private regions. The request is sent to your account team, who will contact you about the request.

When Datacenters exist in your private regions, the Private Regions tab displays information about your private regions and the Datacenters they contain.

You can filter the list of Private Regions using the Search field. You can also sort by column, in ascending or descending order. You can also click the Request New Datacenter link in the top right of the screen to request that additional Datacenters be added to your private regions.

The tab displays the following information about your private regions:

  • Status—The status of the private region, this can either be not yet deployed (a yellow icon), or ready to be used (a green icon).
  • Mode—The Mode column can contain one of three states for the Datacenter:
    • Ready—The Datacenter is ready for the creation of new services.
    • Not Ready—The Datacenter is not ready for the creation of new services.
    • In Maintenance—The Datacenter in available, but services can not currently be created in it due to other ongoing activity.
  • Location—The continent where the Datacenter is located.
  • Datacenter Name—The name of the Datacenter as show in the console user interface.
  • Datacenter ID—The unique identifier for the Datacenter in the private region.
  • Configuration Last Updated—The date in this column represents the last time the values.yaml configuration file for this Datacenter was updated. An entry of Not Configured in this column indicates that the values.yaml file is not ready to be downloaded.
  • Environment—The environment the datacenter is part of. For more information, see Creating and Managing Environments.
  • Untitled column—Contains an ellipse which can be clicked on to access a menu where the values.yaml, Image Pull Secret, and validation tool manifest files can be downloaded.

Downloading the Configuration File for the Mission Control Agent

To access the Private Regions, perform the following steps:

  1. Log in to the PubSub+ Cloud Console if you have not done so yet. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging In to the PubSub+ Cloud Console.

  2. On the navigation bar, click User & Account and then select Account Details.
  3. On the Account Details page, select the Private Regions tab.
  4. Click the ellipse icon () for a listed Datacenter.
  5. From the menu that opens, select Download values.yaml file.

    The values.yaml file for the Datacenter is downloaded securely to your local storage drive via TLS. You can use the values.yaml file to deploy the Mission Control Agent into your Kubernetes cluster, see Kubernetes Cluster Installation.

Downloading Registry Credentials

You can download the registry credentials you need to access the Solace Container Registry (gcr.io) where Solace's images are stored, from the Private Regions tab. Information about the Solace Container Registry is available in Connectivity Model for Kubernetes Deployments.

  1. Log in to the PubSub+ Cloud Console if you have not done so yet. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging In to the PubSub+ Cloud Console.

  2. On the navigation bar, click User & Account and then select Account Details.
  3. On the Account Details page, select the Private Regions tab.
  4. Click the ellipse icon () for a listed Datacenter.

  5. The menu that opens presents one of two options based on your Kubernetes configuration:

    • Download Image Pull Secret—Securely downloads a <datacenter-id>-pull-secret.yaml file containing a manifest for Kubernetes to your local storage drive via TLS.
    • Download Registry Credentials—Securely downloads a <datacenter-id>-registry-credentials.json registry credentials file for Kubernetes to your local storage drive via TLS.

    You can use the contents of either of these files as an authorization token to access the Solace Container Registry (gcr.io) where Solace's container images are stored. For more about deploying Mission Control Agent into your Kubernetes cluster, see Kubernetes Cluster Installation.

Downloading the Validation Tool Manifest

You can download the validation tool manifest that is required by the cluster validation tool when validating your Kubernetes cluster with help from Solace.

  1. Log in to the PubSub+ Cloud Console if you have not done so yet. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging In to the PubSub+ Cloud Console.

  2. On the navigation bar, click User & Account and then select Account Details.
  3. On the Account Details page, select the Private Regions tab.
  4. Click the ellipse icon () for a listed Datacenter.
  5. From the menu that opens, select Download Validation Tool Manifest.

    6. A <datacenterid>.yaml file where datacenterid is the name listed in the Datacenter ID column of the Private Regions table is downloaded securely to your local storage drive via TLS. You can use the <datacenterid>.yaml file to validate your Kubernetes cluster with help from Solace, see Kubernetes Cluster Validation.

Moving a Datacenter to a Different Environment

You can move your datacenters to different environments using the Private Regions tab. For more information about managing environments, see Creating and Managing Environments.

  1. Log in to the PubSub+ Cloud Console if you have not done so yet. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging In to the PubSub+ Cloud Console.

  2. On the navigation bar, click User & Account and then select Account Details.
  3. On the Account Details page, select the Private Regions tab.
  4. Click the ellipse icon () for a listed Datacenter.
  5. From the menu that opens, select Move to Another Environment.
  6. On the Move to Another Environment dialog, in the Destination Environment list select the environment to move the datacenter to.
  7. Click Move.