Quickstart

What you will do

Create a managed cluster in the Kupe Cloud console.
Deploy an application with Argo CD.
Expose the app with an HTTPRoute.
Validate metrics, logs, and events.

Prerequisites

Kupe Cloud account access.
A Git repository with Kubernetes manifests or Helm chart.
Basic kubectl knowledge.

Step 1: Create your cluster

In the console:

Open Clusters.
Select Create Cluster.
Set: : - Cluster name : - Kubernetes version : - CPU, memory, and storage limits
Create and wait for status Running.

Tip: Start small for your first cluster, then scale resources after your first deployment.

Step 2: Deploy your first app with GitOps

Kupe uses a central Argo CD control plane, scoped by tenant AppProjects and destination clusters.

A minimal Application example:

apiVersion: argoproj.io/v1alpha1
kind: Application
metadata:
  name: hello-app
  namespace: argocd
spec:
  project: tenant-acme
  source:
    repoURL: https://github.com/your-org/your-repo.git
    targetRevision: main
    path: deploy/hello-app
  destination:
    name: acme-prod
    namespace: hello-app
  syncPolicy:
    automated:
      prune: true
      selfHeal: true
    syncOptions:
      - CreateNamespace=true

Replace tenant-acme and acme-prod with your tenant AppProject and registered destination cluster name.

Step 3: Expose the app

Create an HTTPRoute and bind it to the platform gateway:

apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
  name: hello-app
  namespace: hello-app
spec:
  parentRefs:
    - name: internal-gateway
      namespace: kube-system
  hostnames:
    - hello.acme.dev.int.kupe.cloud
  rules:
    - matches:
        - path:
            type: PathPrefix
            value: /
      backendRefs:
        - name: hello-app
          port: 80

Step 4: Validate success

In console and dashboards, confirm:

Pods are Running and Ready.
Route is accepted and traffic returns 2xx/3xx responses.
CPU/memory/log signals look healthy.