Skip to main content
Version: 1.47

Okteto BYOC on GCP

Okteto Bring Your Own Cloud (BYOC) runs the Okteto Platform in your own GCP project, fully managed by Okteto. The following steps prepare your Google Cloud project so Okteto can install and operate the platform in it.

Setup Requirements​

Okteto BYOC on GCP needs:

  • A dedicated GCP project for Okteto. We recommend a name like okteto-byoc.

Keep this project isolated from your production workloads, for security and easier management.

Step 1: Share the Project Details​

After you create the project, contact your Okteto representative and share:

  • The name and ID of your GCP project

Step 2: Grant Access​

Your Okteto representative gives you the email address for the Okteto service account. Grant that service account the Owner role in the project:

gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \
--member="serviceAccount:OKTETO_SERVICE_ACCOUNT_EMAIL" \
--role="roles/owner"

Replace YOUR_PROJECT_ID with your GCP project ID and OKTETO_SERVICE_ACCOUNT_EMAIL with the service account email provided by your Okteto representative.

Next Steps​

After you grant access, we take it from there.

Our team:

  • Sets up and configures a GKE cluster in your GCP project
  • Installs Okteto in the GKE cluster
  • Keeps it updated securely with our GitOps practices
  • Makes sure the platform is fully operational and ready to use

We notify you when the installation is complete and give you onboarding support so your team can start building with Okteto.

Cluster Management Guidelines​

After Okteto is installed, don't manually modify the GKE cluster or related infrastructure through the GCP Console, gcloud CLI, or Terraform.

This includes:

  • GKE cluster configuration (node pools, machine types, disk configurations)
  • Kubernetes resources in Okteto-managed namespaces
  • Networking, load balancers, or storage resources created by Okteto

Manual changes can cause service degradation and state inconsistencies, and they break our SLA commitments. If you need infrastructure changes, contact your Okteto representative.

The cluster management restrictions for BYOC have more details.