Assembling a deployment command v1

For a quick installation with the aim of testing the product, see Quick start.

For more targeted testing or production purposes, you can assemble a command to deploy EDB Postgres Distributed for Kubernetes with the operand and proxy image versions of your choice.

Prerequisites

Gather the following information:

• Repository name
• Your repository token
• Operand image name
• Proxy image name

Assembling your command

Replace the placeholders in <...> with the gathered information:

helm upgrade --dependency-update \
  --install edb-pg4k-pgd \ 
  --namespace pgd-operator-system \
  --create-namespace \
  edb/edb-postgres-distributed-for-kubernetes \
  --set edb-postgres-for-kubernetes.enabled=true \
  --set image.repository=docker.enterprisedb.com/<REPOSITORY_NAME>/pg4k-pgd \ 
  --set edb-postgres-for-kubernetes.image.repository=docker.enterprisedb.com/<REPOSITORY_NAME>/edb-postgres-for-kubernetes \
  --set config.data.PGD_IMAGE_NAME=docker.enterprisedb.com/<REPOSITORY_NAME>/<OPERAND_NAME> \
  --set config.data.PGD_PROXY_IMAGE_NAME=docker.enterprisedb.com/<REPOSITORY_NAME>/<PGD-PROXY>
  --set image.imageCredentials.username=<REPOSITORY_NAME> \
  --set image.imageCredentials.password=<EDB_SUBSCRIPTION_TOKEN>

After assembling the command with the required images, see Installation for instructions on how to add the repository, deploy the images, and create a certificate issuer.

Examples

These example commands:

• Pull images from the k8s_enterprise_pgd repository.
• Use EBD Postgres Advanced Server 15.6.2 as the Postgres option.
• Use PGD 5.4.1 as the Postgres Distributed version.
• Use 5.4.0 as the PGD Proxy version.

Example 1: Setting the environment variables before you run the deployment command

Set the environment variables for the deployment command:

1. Set the environment variable to pull images from the k8s_enterprise_pgd repository:

   → WrapCopy

   export REPOSITORY_NAME=k8s_enterprise_pgd

2. Set the environment variable to use your personal token:

   → WrapCopy

   export EDB_SUBSCRIPTION_TOKEN=<my_registry_token>

3. Set the environment variable to use EBD Postgres Advanced Server 15.6.2 as the Postgres option and PGD 5.4.1 as the Postgres Distributed version:

   → WrapCopy

   export OPERAND_NAME=edb-postgres-advanced-pgd:15.6.2-5.4.1-1

4. Set the environment variable to use 5.4.0 as the PGD Proxy version:

   → WrapCopy

   export PGD-PROXY=edb-pgd-proxy:5.4.0

5. Run the deployment command:

   → WrapCopy

   helm upgrade --dependency-update \
     --install edb-pg4k-pgd \ 
     --namespace pgd-operator-system \
     --create-namespace \
     edb/edb-postgres-distributed-for-kubernetes \
     --set edb-postgres-for-kubernetes.enabled=true \
     --set image.repository=docker.enterprisedb.com/${REPOSITORY_NAME}/pg4k-pgd \ 
     --set edb-postgres-for-kubernetes.image.repository=docker.enterprisedb.com/${REPOSITORY_NAME}/edb-postgres-for-kubernetes \
     --set config.data.PGD_IMAGE_NAME=docker.enterprisedb.com/${REPOSITORY_NAME}/${OPERAND_NAME} \
     --set config.data.PGD_PROXY_IMAGE_NAME=docker.enterprisedb.com/${REPOSITORY_NAME}/${PGD-PROXY}
     --set image.imageCredentials.username=${REPOSITORY_NAME} \
     --set image.imageCredentials.password=${EDB_SUBSCRIPTION_TOKEN}

Example 2: Replacing the placeholders manually

1. Set the environment variable to use your personal token:

   → WrapCopy

   export EDB_SUBSCRIPTION_TOKEN=<my_registry_token>

2. Insert the repository, image, and proxy names into the command:

   → WrapCopy

   helm upgrade --dependency-update \
     --install edb-pg4k-pgd \ 
     --namespace pgd-operator-system \
     --create-namespace \
     edb/edb-postgres-distributed-for-kubernetes \
     --set edb-postgres-for-kubernetes.enabled=true \
     --set image.repository=docker.enterprisedb.com/k8s_enterprise_pgd/pg4k-pgd \ 
     --set edb-postgres-for-kubernetes.image.repository=docker.enterprisedb.com/k8s_enterprise_pgd/edb-postgres-for-kubernetes \
     --set config.data.PGD_IMAGE_NAME=docker.enterprisedb.com/k8s_enterprise_pgd/edb-postgres-advanced-pgd:15.6.2-5.4.1-1 \
     --set config.data.PGD_PROXY_IMAGE_NAME=docker.enterprisedb.com/k8s_enterprise_pgd/edb-pgd-proxy:5.4.0
     --set image.imageCredentials.username=k8s_enterprise_pgd \
     --set image.imageCredentials.password=${EDB_SUBSCRIPTION_TOKEN}