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.