/* Copyright 2019 The Knative Authors Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. */ package gke import ( "errors" container "google.golang.org/api/container/v1beta1" ) const defaultGKEVersion = "latest" // Request contains all settings collected for cluster creation type Request struct { // Project: name of the gcloud project for the cluster Project string // GKEVersion: GKE version of the cluster, default to be latest if not provided GKEVersion string // ClusterName: name of the cluster ClusterName string // MinNodes: the minimum number of nodes of the cluster MinNodes int64 // MaxNodes: the maximum number of nodes of the cluster MaxNodes int64 // NodeType: node type of the cluster, e.g. n1-standard-4, n1-standard-8 NodeType string // Region: region of the cluster, e.g. us-west1, us-central1 Region string // Zone: default is none, must be provided together with region Zone string // Addons: cluster addons to be added to cluster, such as istio Addons []string // EnableWorkloadIdentity: whether to enable Workload Identity - // https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity or not EnableWorkloadIdentity bool } // DeepCopy will make a deepcopy of the request struct. func (r *Request) DeepCopy() *Request { return &Request{ Project: r.Project, GKEVersion: r.GKEVersion, ClusterName: r.ClusterName, MinNodes: r.MinNodes, MaxNodes: r.MaxNodes, NodeType: r.NodeType, Region: r.Region, Zone: r.Zone, Addons: r.Addons, EnableWorkloadIdentity: r.EnableWorkloadIdentity, } } // NewCreateClusterRequest returns a new CreateClusterRequest that can be used in gcloud SDK. func NewCreateClusterRequest(request *Request) (*container.CreateClusterRequest, error) { if request.ClusterName == "" { return nil, errors.New("cluster name cannot be empty") } if request.MinNodes <= 0 { return nil, errors.New("min nodes must be larger than 1") } if request.MinNodes > request.MaxNodes { return nil, errors.New("min nodes cannot be larger than max nodes") } if request.NodeType == "" { return nil, errors.New("node type cannot be empty") } if request.EnableWorkloadIdentity && request.Project == "" { return nil, errors.New("project cannot be empty if you want Workload Identity") } if request.GKEVersion == "" { request.GKEVersion = defaultGKEVersion } ccr := &container.CreateClusterRequest{ Cluster: &container.Cluster{ NodePools: []*container.NodePool{ { Name: "default-pool", InitialNodeCount: request.MinNodes, Autoscaling: &container.NodePoolAutoscaling{ Enabled: true, MinNodeCount: request.MinNodes, MaxNodeCount: request.MaxNodes, }, Config: &container.NodeConfig{ MachineType: request.NodeType, }, }, }, Name: request.ClusterName, // The default cluster version is not latest, has to explicitly // set it as "latest" InitialClusterVersion: request.GKEVersion, // Installing addons after cluster creation takes at least 5 // minutes, so install addons as part of cluster creation, which // doesn't seem to add much time on top of cluster creation AddonsConfig: GetAddonsConfig(request.Addons), // Equivalent to --enable-basic-auth, so that user:pass can be // later on retrieved for setting up cluster roles. Use the // default username from gcloud command, the password will be // automatically generated by GKE SDK MasterAuth: &container.MasterAuth{Username: "admin"}, }, } if request.EnableWorkloadIdentity { // Equivalent to --identity-namespace=[PROJECT_ID].svc.id.goog, then // we can configure a Kubernetes service account to act as a Google // service account. ccr.Cluster.WorkloadIdentityConfig = &container.WorkloadIdentityConfig{ IdentityNamespace: request.Project + ".svc.id.goog", } } return ccr, nil }