Skip to main content
Version: latest

PCG

The pcg command supports Private Cloud Gateway (PCG) operations, such as installing a PCG cluster and validating its installation. A local kind cluster is created to facilitate creating the PCG cluster in the target environment. You do not need to install kind or any other dependencies. The CLI includes all the required dependencies to set up the kind cluster.

Subcommands

The pcg command exposes the following subcommand.


  • install - Install a PCG through an interactive wizard. A container runtime is required to install a PCG cluster.

Prerequisites

  • Docker is required to install a PCG cluster. Refer to the Docker documentation to learn how to install Docker on your system.

Install

Use the install subcommand to install a PCG cluster in the following environments. The following flags are supported by the install subcommand.


Short FlagLong FlagDescriptionType
-f--config-fileInstall using a configuration file (optional). Use -config-only to generate a configuration file.string
-o--config-onlyGenerate configuration file only. This command will not proceed with installation.boolean
-h--helpHelp for the install command.boolean
-p--update-passwordsUse to update the PCG password. This does not proceed with installation. The --config-file flag must be provided. Default: false.boolean
warning

Use the latest version of the Palette CLI that matches the version of your Palette or Palette VerteX instance. You can find the newest version of the Palette CLI on the Downloads page.

Generate a Configuration File

Use the --config-only flag to generate a configuration file. The configuration file is used to install a PCG cluster with pre-defined values without having to go through the interactive wizard.

palette pcg install --config-only

Upon completion of the wizard installation, the configuration file is generated in the HOME directory under the folder path .palette/pcg/. The configuration file is named pcg.yaml.

==== Create PCG reference config ====
==== PCG config saved ====
Location: /Users/demo/.palette/pcg/pcg-20240108150653/pcg.yaml

Install With a Configuration File

Use the --config-file flag to install a PCG cluster with a configuration file. You can generate a configuration file using the --config-only flag. Refer to the Generate a Configuration File section for more information.

palette pcg install --config-file <path-to-config-file>

Update Passwords

You can update the Ubuntu Pro token and the platform credentials in the configuration file using the --update-passwords flag. The --config-file flag must be provided. The --update-passwords flag does not proceed with installation.

palette pcg install --config-file <path-to-config-file> --update-passwords

Supported Environments

You can use the install subcommand to install a PCG cluster in the following environments.

PlatformInstall Guide
MAASLink
OpenStackLink
VMwareLink