Skip to main content

Create your first valkey cluster using Aonnis Valkey Panther

Prerequisits​

  1. Kubernetes cluster
    For this guide, you can use any Kubernetes cluster, including Amazon EKS, Azure AKS, Google GKE, Civo, or any other managed Kubernetes service. If you prefer to test locally, we recommend using Kind (Kubernetes in Docker). To get started, refer to the Kind Quick Start Documentation for installation instructions. Once installed, you can create a new cluster using the following script:

    Create Kind cluster
    git clone https://gitlab.com/aonniscloud/getting-started.git
    cd getting-started
    kind create cluster --name local-k8s-cluster --config kind_config.yml

  2. Cert-manager
    Aonnis Valkey Panther relies on cert-manager to create secure HTTP webhooks. These webhooks are essential for validating and defaulting incoming requests related to cluster management. Installing cert-manager is a prerequisite to ensure secure and seamless operation of Aonnis Valkey Panther. Refer cert-manager's documentation for installation.

Steps to create your first Aonnis valkey cluster​

  1. Login to Aonnis Web Console
    Sign in to the Aonnis Web Console to create an Aonnis Valkey Panther license. Please create an account if you do not have one.

  2. Create a License
    Ensure your account has the required minimum credit balance, then create a license and its access key by following this.

    1. Make sure to create a Kubernetes secrete according to this link for storing licence access key on kubernetes cluster.
    2. This secret (license) will be used by Aonnis Valkey Panther.

  1. Set up image pull secret
    Follow this to setup image pull secret. These credentials are necessary for your Kubernetes environment to pull the Aonnis Valkey Panther image for the first deployment. Once Aonnis Valkey Panther is deployed and managing at least one Valkey Cluster or Valkey-compatible database, it will automatically keep these credentials updated in the associated Kubernetes secret.

  2. Install CRD Install Aonnis Valkey Cluster CRD by following this link.

  3. Clone getting started helm charts

    1. Clone getting started Aonnis Valkey Clsuter and Aonnis Valkey Panther helm charts.

      Clone getting started repository
      git clone https://gitlab.com/aonniscloud/getting-started.git

    2. After clonning make sure to update following things:

      1. Image pull secret in values.yaml file for valkey panther helm chart (required only if license secret is create with a different name than avp-image-pull-secret).
      2. Valkey version in values.yaml file for valkey cluster helm chart.
        1. If specific Valkey version is required, click here to check supported valkey versions.
      3. Image tag to use in values.yaml file for valkey panther helm chart. Choose latest Aonnis Valkey Panther image tag from here
      4. licenseAccessKeySecretRef in values.yaml for valkey clsuter helm chart.

  4. Deploy Valkey Panther and Valkey Cluster
    Deploy your Valkey Cluster in your Kubernetes environment, leveraging the capabilities of Aonnis Valkey Panther for efficient management.

    Deploy Aonnis valkey panther and valkey clsuter
    helm install --wait valkey-panther valkey/valkey-panther && \
    helm install --wait valkey-cluster valkey/valkey-cluster

By following these steps, you can set up and use Aonnis Valkey Panther to manage your Valkey clusters and compatible databases in a Kubernetes environment.