Deploy Hyperswitch on Kubernetes
Install Hyperswitch on your K8s setup using our Helm charts
Part 1: Setting Up a Kubernetes Cluster on GCP
Step 1: Set Up GCP Account and Enable Kubernetes Engine API
Sign In to Google Cloud Console:
Go to the Google Cloud Console.
Create a Project:
Click Create Project, provide a project name, and click Create.
If using an existing project, note the project ID for later use.
Enable Kubernetes Engine API:
Navigate to APIs & Services > Library.
Search for Kubernetes Engine API and click Enable.
Step 2: Install Required Tools
Install Google Cloud SDK:
On macOS:
For Linux and Windows, refer to Google Cloud SDK installation guide.
Initialize
gcloud
CLI:Authenticate and configure your project:
Follow the prompts to log in, select your project, and set a default compute region/zone.
Install kubectl:
Use
gcloud
to install Kubernetes CLI:
Step 3: Create a Kubernetes Cluster
Create the Cluster:
Run the following command to create a Kubernetes cluster:
Replace:
<CLUSTER_NAME>
: A unique name for your cluster.<ZONE>
: The GCP zone (e.g.,us-central1-a
).<NUMBER_OF_NODES>
: Number of nodes in your cluster.e2-standard-4
: Machine type with 4 CPUs and 16GB RAM per node.
Example:
Verify the Cluster:
Fetch cluster credentials to allow
kubectl
to interact with it:Confirm the nodes are ready:
Part 2: Deploy Hyperswitch on Kubernetes Using Helm
Step 1: Add and Update the Hyperswitch Helm Repository
Add the Hyperswitch Helm repository:
Update Helm repository to fetch the latest charts:
Step 2: Prepare the Kubernetes Cluster
Label Kubernetes Nodes:
Ensure nodes meet the minimum requirements: 4 CPUs and 6GB memory.
Label your nodes:
List nodes to confirm labels:
Create a Namespace:
Create a dedicated namespace for Hyperswitch:
Step 3: Install Hyperswitch
Install Hyperswitch services using Helm:
Verify the Deployment:
Check the status of all deployed pods:
Ensure all pods are in the
Running
state.
That's it! Hyperswitch should be up and running on your GCP account 🎉 🎉
Post-Deployment Checklist
After deploying the Helm chart, you should verify that everything is working correctly
App Server
Control Center
Test a payment
Step 1 - Make a payment using our Demo App
Use the Hyperswitch Demo app and make a payment with test card.
Refer our postman collection to try out REST APIs
Step 2 - Deploy card vault
If you intend to save cards of your customers for future usage then you need a Card Vault. This helm chart doesn't cover inbuilt card vault support as it will violate PCI compliance. You can install manually by following the steps here or use this doc to deploy card vault in aws.
Next step:
Account setupLast updated