Skip to content
logo
Percona Operator for PostgreSQL
Install with Helm
Initializing search
    percona/k8spg-docs
    percona/k8spg-docs
    • Welcome
      • System Requirements
      • Design and architecture
      • Comparison with other solutions
      • Install on Minikube
      • Install on Google Kubernetes Engine (GKE)
      • Install with Helm
        • Pre-requisites
        • Installation
        • Installing Percona Distribution for PostgreSQL with customized parameters
      • Generic Kubernetes installation
      • Install on OpenShift
      • Application and system users
      • Changing PostgreSQL Options
      • Anti-affinity and tolerations
      • Transport Encryption (TLS/SSL)
      • Telemetry
      • Backup and restore
      • Upgrade Percona Distribution for PostgreSQL and the Operator
      • Horizontal and vertical scaling
      • Monitor with Percona Monitoring and Management (PMM)
      • Restart or pause the cluster
      • Deploy a standby cluster for Disaster Recovery
      • Provide Percona Operator for PostgreSQL single-namespace and multi-namespace deployment
      • Use PostgreSQL tablespaces with Percona Operator for PostgreSQL
      • Custom Resource options
      • Operator installation options
      • Percona certified images
      • Frequently Asked Questions
      • Release notes index
      • Percona Operator for PostgreSQL 1.3.0 (2022-08-04)
      • Percona Operator for PostgreSQL 1.2.0 (2022-04-06)
      • Percona Operator for PostgreSQL 1.1.0 (2021-12-07)
      • Percona Operator for PostgreSQL 1.0.0 (2021-10-07)
      • Percona Operator for PostgreSQL 0.2.0 (2021-08-12)
      • Percona Operator for PostgreSQL 0.1.0 (2021-05-10)

    • Pre-requisites
    • Installation
    • Installing Percona Distribution for PostgreSQL with customized parameters

    Install Percona Distribution for PostgreSQL using Helm¶

    Helm is the package manager for Kubernetes. Percona Helm charts can be found in percona/percona-helm-charts repository in Github.

    Pre-requisites¶

    Install Helm following its official installation instructions.

    Note

    Helm v3 is needed to run the following steps.

    Installation¶

    1. Add the Percona’s Helm charts repository and make your Helm client up to date with it:

      $ helm repo add percona https://percona.github.io/percona-helm-charts/
      $ helm repo update
      
    2. Install the Percona Operator for PostgreSQL:

      $ helm install my-operator percona/pg-operator --version 1.3.0
      

      The my-operator parameter in the above example is the name of a new release object which is created for the Operator when you install its Helm chart (use any name you like).

      Note

      If nothing explicitly specified, helm install command will work with default namespace. To use different namespace, provide it with the following additional parameter: --namespace my-namespace.

    3. Install PostgreSQL:

      $ helm install my-db percona/pg-db --version 1.3.0 --namespace my-namespace
      

      The my-db parameter in the above example is the name of a new release object which is created for the Percona Distribution for PostgreSQL when you install its Helm chart (use any name you like).

    Installing Percona Distribution for PostgreSQL with customized parameters¶

    The command above installs Percona Distribution for PostgreSQL with default parameters. Custom options can be passed to a helm install command as a --set key=value[,key=value] argument. The options passed with a chart can be any of the Operator’s Custom Resource options.

    The following example will deploy a Percona Distribution for PostgreSQL Cluster in the pgdb namespace, with enabled Percona Monitoring and Management (PMM) and 20 Gi storage for a Primary PostgreSQL node:

    $ helm install my-db percona/pg-db --version 1.3.0 --namespace pgdb \
      --set pgPrimary.volumeSpec.size=20Gi \
      --set pmm.enabled=true
    

    Contact Us

    For free technical help, visit the Percona Community Forum.

    To report bugs or submit feature requests, open a JIRA ticket.

    For paid support and managed or consulting services , contact Percona Sales.


    Last update: 2023-02-09
    Back to top
    Percona LLC and/or its affiliates, © 2009 - 2022
    Made with Material for MkDocs

    Cookie consent

    We use cookies to recognize your repeated visits and preferences, as well as to measure the effectiveness of our documentation and whether users find what they're searching for. With your consent, you're helping us to make our documentation better.