Instale o GCP Service Broker

Observação: o agente de serviços do GCP não é um produto do Google oficialmente compatível e não é um componente compatível do Kf.

Este documento é uma versão modificada da documentação encontrada no repositório do GitHub para o GCP Service Broker.

Pré-requisitos

1. Um cluster com Kf instalado.
2. gcloud: siga estas instruções (em inglês) para instalar a gcloud CLI.
3. kubectl: depois que gcloud for instalado, execute gcloud components install kubectl.
4. helm: siga estas instruções (em inglês) para instalar a CLI helm.
5. git: o Git é necessário para clonar um repositório.

Configuração

Selecione um projeto

Escolha o projeto do Google Cloud que você quer usar no restante deste tutorial. Ele precisa ser o mesmo projeto usado pelo cluster Kf.

Você precisa ser o proprietário do projeto escolhido. Se necessário, altere os valores abaixo para refletir seu ambiente e defina essas variáveis de ambiente no seu terminal:

export PROJECT_ID=$(gcloud config get-value project)
export SERVICE_ACCOUNT_NAME=kf-gcp-broker

Criar uma conta de serviço para o agente

1. Crie a conta de serviço:

   gcloud iam service-accounts create $SERVICE_ACCOUNT_NAME

2. Crie novas credenciais para permitir que o agente seja autenticado e faça o download da credencial para key.json:

   gcloud iam service-accounts keys create key.json --iam-account $SERVICE_ACCOUNT_NAME@$PROJECT_ID.iam.gserviceaccount.com

3. Conceda permissões de proprietário do projeto ao agente:

   gcloud projects add-iam-policy-binding $PROJECT_ID --member serviceAccount:$SERVICE_ACCOUNT_NAME@$PROJECT_ID.iam.gserviceaccount.com --role "roles/owner"

   Observação: em vez de usar permissões de proprietário, você pode adicionar permissões de administrador ao agente para cada serviço individual que queira provisionar com o agente.

Ativar APIs obrigatórias

Agora você precisa ativar as APIs para permitir que o agente provisione recursos.

O agente tem algumas APIs necessárias para ser executada e algumas opcionais, mas que precisam estar ativadas para provisionar recursos de um tipo específico.

As APIs Cloud Resource Manager e Identity and Access Management são necessárias para a execução do agente. Para ativá-las:

gcloud services enable cloudresourcemanager.googleapis.com iam.googleapis.com --project $PROJECT_ID

Ativar APIs

Para provisionar os serviços do Cloud no seu projeto, o Kf recomenda ativar pelo menos as seguintes APIs:

1. API CloudSQL
2. API CloudSQL Admin
3. Pub/Sub API
4. API Redis
5. API Storage

O agente de serviços do GCP também é compatível com vários outros serviços aos quais você pode adicionar suporte ativando as APIs listadas aqui.

Instalar o agente de serviços

1. Clone o GCP Service Broker na estação de trabalho local e cd em:

   git clone --depth=1 "https://github.com/GoogleCloudPlatform/gcp-service-broker"
   cd gcp-service-broker/deployments/helm/gcp-service-broker

2. Atualize as dependências do gráfico do Helm:

   helm dependency update

3. Edite o arquivo values.yaml e defina o valor de broker.service_account_json como uma string com todo o conteúdo de key.json.

   Opcional: leia as demais propriedades e altere as que forem necessárias para se ajustar ao ambiente.

   # ...
   broker:
     # ...
     service_account_json: "contents of key.json go here"
   # ...

4. Se estiver em execução em um ambiente de produção, defina mysql.embedded como falso e forneça credenciais para um banco de dados MySQL externo que tenha backups automáticos e failover.

   Observação: o banco de dados integrado pode iniciar a execução rapidamente, mas não pode ser usado como uma solução pronta para produção.

5. Crie um namespace do Kubernetes para o GCP Service Broker:

   kubectl create namespace gcp-service-broker

6. Instale o agente:

   helm install gcp-service-broker --set svccat.register=false --namespace gcp-service-broker .

   Observação: se você receber um erro sobre YAML inválido no secrets.yaml, verifique se o valor de broker.service_account_json no campo values.yaml foi formatado como string.

7. Registre o agente no Kf:

   kf create-service-broker gcp-service-broker \
     "$(kubectl get secret gcp-service-broker-auth -n gcp-service-broker -o jsonpath='{.data.username}' | base64 --decode)" \
     "$(kubectl get secret gcp-service-broker-auth -n gcp-service-broker -o jsonpath='{.data.password}' | base64 --decode)" \
     "http://gcp-service-broker.gcp-service-broker.svc.cluster.local"

   Observação: talvez leve vários minutos para que o agente seja acessado.

Confirmar a instalação do agente

Execute kf marketplace. Você verá uma resposta similar a:

Broker              Name                          Space       Status  Description
gcp-service-broker  google-stackdriver-profiler               Active  Continuous CPU and heap profiling to improve performance and reduce costs.
gcp-service-broker  google-stackdriver-monitoring             Active  Stackdriver Monitoring provides visibility into the performance, uptime, and overall health of cloud
gcp-service-broker  google-dataflow                           Active  A managed service for executing a wide variety of data processing patterns built on Apache Beam.
gcp-service-broker  google-cloudsql-mysql                     Active  Google CloudSQL for MySQL is a fully-managed MySQL database service.
gcp-service-broker  google-spanner                            Active  The first horizontally scalable, globally consistent, relational database service.
gcp-service-broker  google-ml-apis                            Active  Machine Learning APIs including Vision, Translate, Speech, and Natural Language.
gcp-service-broker  google-pubsub                             Active  A global service for real-time and reliable messaging and streaming data.
gcp-service-broker  google-datastore                          Active  Google Cloud Datastore is a NoSQL document database service.
gcp-service-broker  google-stackdriver-debugger               Active  Stackdriver Debugger is a feature of the Google Cloud Platform that lets you inspect the state of an
gcp-service-broker  google-firestore                          Active  Cloud Firestore is a fast, fully managed, serverless, cloud-native NoSQL document database that simp
gcp-service-broker  google-bigtable                           Active  A high performance NoSQL database service for large analytical and operational workloads.
gcp-service-broker  google-storage                            Active  Unified object storage for developers and enterprises. Cloud Storage allows world-wide storage and r
gcp-service-broker  google-stackdriver-trace                  Active  Stackdriver Trace is a distributed tracing system that collects latency data from your applications
gcp-service-broker  google-cloudsql-postgres                  Active  Google CloudSQL for PostgreSQL is a fully-managed PostgreSQL database service.
gcp-service-broker  google-dialogflow                         Active  Dialogflow is an end-to-end, build-once deploy-everywhere development suite for creating conversatio
gcp-service-broker  google-bigquery                           Active  A fast, economical and fully managed data warehouse for large-scale data analytics.

O GCP Service broker está instalado e pode ser usado para criar serviços e vinculá-los a aplicativos implantados com o Kf.