Deployment di Kf Cloud Service Broker

Questa pagina mostra come eseguire il deployment di Kf Cloud Service Broker per Google Cloud e utilizzarlo per eseguire il provisioning o il deprovisioning delle risorse di supporto. Scopri di più su concetti e architettura per saperne di più sul broker di servizi Kf Cloud.

Crea variabili di ambiente

Linux

export PROJECT_ID=YOUR_PROJECT_ID
export CLUSTER_PROJECT_ID=YOUR_PROJECT_ID
export CLUSTER_NAME=kf-cluster
export INSTANCE_NAME=cloud-service-broker
export COMPUTE_REGION=us-central1

Windows PowerShell

Set-Variable -Name PROJECT_ID -Value YOUR_PROJECT_ID
Set-Variable -Name CLUSTER_PROJECT_ID -Value YOUR_PROJECT_ID
Set-Variable -Name CLUSTER_NAME -Value kf-cluster
Set-Variable -Name INSTANCE_NAME -Value cloud-service-broker
Set-Variable -Name COMPUTE_REGION -Value us-central1

Configura il database Kf Cloud Service Broker

1. Creare un'istanza Cloud SQL per MySQL.

   Nota: leggi Creazione e gestione degli utenti MySQL per Cloud SQL per MySQL e imposta una password sicura per l'utente root predefinito.

   gcloud sql instances create ${INSTANCE_NAME} --cpu=2 --memory=7680MB --require-ssl --region=${COMPUTE_REGION}
   

2. Crea un database denominato servicebroker nell'istanza Cloud SQL per MySQL.

   Nota: documenta il nome del database poiché viene utilizzato nei passaggi successivi.

   gcloud sql databases create servicebroker -i ${INSTANCE_NAME}

3. Crea un nome utente e una password che il broker di servizi Kf Cloud possa utilizzare.

   Nota: annota questi valori, poiché verranno utilizzati nei passaggi successivi.

   gcloud sql users create csbuser -i ${INSTANCE_NAME} --password=csbpassword

Configura un account di servizio Google per Kf Cloud Service Broker

1. Crea un account di servizio Google.

   gcloud iam service-accounts create csb-${CLUSTER_NAME}-sa \
     --project=${CLUSTER_PROJECT_ID} \
     --description="GSA for CSB at ${CLUSTER_NAME}" \
     --display-name="csb-${CLUSTER_NAME}"

2. Concedi le autorizzazioni roles/cloudsql.client all'account di servizio. Questo passaggio è necessario per connettere il pod Kf Cloud Service Broker all'istanza Cloud SQL per MySQL tramite il proxy di autenticazione Cloud SQL.

   gcloud projects add-iam-policy-binding ${CLUSTER_PROJECT_ID} \
     --member="serviceAccount:csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com" \
     --role="roles/cloudsql.client"

3. Concedi ulteriori autorizzazioni Google Cloud all'account di servizio.

   Nota: nell'esempio riportato di seguito, vengono assegnati i ruoli IAM necessari per il provisioning di un'istanza di Cloud SQL per MySQL e Memorystore. Devi concedere a questo account di servizio i ruoli appropriati per eseguire il provisioning delle istanze di altri servizi gestiti Google Cloud elencati in kf marketplace.

   gcloud projects add-iam-policy-binding ${CLUSTER_PROJECT_ID} \
     --member="serviceAccount:csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com" \
     --role="roles/compute.networkUser"

   gcloud projects add-iam-policy-binding ${CLUSTER_PROJECT_ID} \
     --member="serviceAccount:csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com" \
     --role="roles/cloudsql.admin"

   gcloud projects add-iam-policy-binding ${CLUSTER_PROJECT_ID} \
     --member="serviceAccount:csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com" \
     --role="roles/redis.admin"

4. Verifica le autorizzazioni.

   Avviso: sostituisci la variabile CSB_SERVICE_ACCOUNT_NAME nel codice YAML di seguito con l'account di servizio completo risolto da csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com

   gcloud projects get-iam-policy ${CLUSTER_PROJECT_ID} \
     --filter='bindings.members:serviceAccount:"CSB_SERVICE_ACCOUNT_NAME"' \
     --flatten="bindings[].members"

Configurazione di Workload Identity per Kf Cloud Service Broker

1. Associare l'account di servizio Google all'account di servizio Kubernetes.

   gcloud iam service-accounts add-iam-policy-binding "csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com" \
     --project=${CLUSTER_PROJECT_ID} \
     --role="roles/iam.workloadIdentityUser" \
     --member="serviceAccount:${CLUSTER_PROJECT_ID}.svc.id.goog[kf-csb/csb-user]"

2. Verifica l'associazione.

   gcloud iam service-accounts get-iam-policy "csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com" \
     --project=${CLUSTER_PROJECT_ID}

Configura un secret di Kubernetes per condividere la configurazione con Kf Cloud Service Broker

1. Crea un file config.yml.

   Nota: se vuoi, sostituisci l'utente e la password predefiniti. Assicurati di aver impostato CLUSTER_PROJECT_ID nel passaggio Creare variabili di ambiente.

   cat << EOF >> ./config.yml
   gcp:
     credentials: ""
     project: ${CLUSTER_PROJECT_ID}
   db:
     host: 127.0.0.1
     password: csbpassword
     user: csbuser
     tls: false
   api:
     user: servicebroker
     password: password
   EOF
   

2. Crea lo spazio dei nomi kf-csb.

   kubectl create ns kf-csb
   

3. Crea il secret di Kubernetes.

   kubectl create secret generic csb-secret --from-file=config.yml -n kf-csb
   

Installa Kf Cloud Service Broker

1. Scarica il kf-csb.yml.

   gsutil cp gs://kf-releases/csb/v1.0.0/kf-csb.yaml /tmp/kf-csb.yaml
   

2. Modifica /tmp/kf-csb.yaml e sostituisci i segnaposto con i valori finali. Nell'esempio seguente, viene utilizzato sed.

   sed -i "s|<GSA_NAME>|csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com|g" /tmp/kf-csb.yaml
   sed -i "s|<INSTANCE_CONNECTION_NAME>|${CLUSTER_PROJECT_ID}:${COMPUTE_REGION}:${INSTANCE_NAME}|g" /tmp/kf-csb.yaml
   sed -i "s|<DB_PORT>|3306|g" /tmp/kf-csb.yaml
   

3. Applica YAML per Kf Cloud Service Broker.

   kubectl apply -f /tmp/kf-csb.yaml
   

4. Verifica lo stato di installazione di Kf Cloud Service Broker.

   kubectl get pods -n kf-csb
   

Crea un service broker

Nota: l'utente e la password devono corrispondere a quelli inseriti nel passaggio Secret Kubernetes in precedenza.

  kf create-service-broker cloud-service-broker servicebroker password http://csb-controller.kf-csb/

Convalida installazione

Verifica la presenza di servizi disponibili nel marketplace.

  kf marketplace

Se tutto è installato e configurato correttamente, dovresti vedere quanto segue:

  $ kf marketplace

  Broker                Name                          Namespace  Description
  cloud-service-broker  csb-google-bigquery                      A fast, economical and fully managed data warehouse for large-scale data analytics.
  cloud-service-broker  csb-google-dataproc                      Dataproc is a fully-managed service for running Apache Spark and Apache Hadoop clusters in a simpler, more cost-efficient way.
  cloud-service-broker  csb-google-mysql                         Mysql is a fully managed service for the Google Cloud Platform.
  cloud-service-broker  csb-google-postgres                      PostgreSQL is a fully managed service for the Google Cloud Platform.
  cloud-service-broker  csb-google-redis                         Cloud Memorystore for Redis is a fully managed Redis service for the Google Cloud Platform.
  cloud-service-broker  csb-google-spanner                       Fully managed, scalable, relational database service for regional and global application data.
  cloud-service-broker  csb-google-stackdriver-trace             Distributed tracing service
  cloud-service-broker  csb-google-storage-bucket                Google Cloud Storage that uses the Terraform back-end and grants service accounts IAM permissions directly on the bucket.

Esegui la pulizia

1. Elimina cloud-service-broker.

   kf delete-service-broker cloud-service-broker
   

2. Elimina componenti CSB.

   kubectl delete ns kf-csb
   

3. Elimina l'istanza Cloud SQL per MySQL di Cloud Service Broker.

   gcloud sql instances delete ${INSTANCE_NAME} --project=${CLUSTER_PROJECT_ID}

4. Rimuovi le associazioni di criteri IAM.

   gcloud projects remove-iam-policy-binding ${CLUSTER_PROJECT_ID} \
   --member='serviceAccount:csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com' \
   --role=roles/cloudsql.client

   gcloud projects remove-iam-policy-binding ${CLUSTER_PROJECT_ID} \
   --member='serviceAccount:csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com' \
   --role=roles/compute.networkUser

   gcloud projects remove-iam-policy-binding ${CLUSTER_PROJECT_ID} \
   --member='serviceAccount:csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com' \
   --role=roles/redis.admin

5. Rimuovi l'appliance di ricerca Google.

   gcloud iam service-accounts delete csb-${CLUSTER_NAME}-sa@${CLUSTER_PROJECT_ID}.iam.gserviceaccount.com \
     --project=${CLUSTER_PROJECT_ID}

Che cosa succede dopo?

• Testa Kf Cloud Service Broker con la nostra guida Spring Music.