Como gerenciar e excluir recursos

Neste tópico, mostramos como o Config Connector utiliza a orquestração e os objetos do Kubernetes para gerenciar os recursos do Google Cloud. Aprenda como o Config Connector gerencia um recurso existente e lida com exclusão de recursos.

Como criar um recurso

Quando você cria um recurso com uma Definição de recurso personalizado (CRD) do Config Connector, é criado um recurso associado do Google Cloud. O Config Connector gerencia esse recurso. Se já existe um recurso do Google Cloud com o mesmo nome, o Config Connector adquire o recurso e o gerencia.

Para mais informações sobre como criar recursos, consulte Introdução.

Como adquirir um recurso existente

Nesta seção, descrevemos como adquirir um recurso existente do BigQuery com o Config Connector.

Antes de começar

  1. Ativar a API BigQuery.
  2. Confirme se você tem acesso à ferramenta de linha de comando bq. Se você não tiver bq, use o Cloud Shell ou instale-o com o SDK do gcloud.

Como adquirir um conjunto de dados do BigQuery

O Config Connector adquire ou assume o controle de recursos quando os valores no manifesto e o nome do recurso correspondem. Se um recurso não tiver um nome (por exemplo, um código do projeto), o código do recurso será usado.

Criando e adquirindo um conjunto de dados vazio do BigQuery, é possível aprender como o Config Connector lida com os recursos existentes.

  1. Crie um conjunto de dados do BigQuery chamado bigquerydatasetsample com bq.

    bq --location=US mk \
    --dataset \
    --default_table_expiration 3600 \
    --description description \
    [PROJECT_ID]:bigquerydatasetsample
  2. Copie o conteúdo a seguir em um arquivo chamado bq-sample.yaml.

      apiVersion: bigquery.cnrm.cloud.google.com/v1beta1
      kind: BigQueryDataset
      metadata:
        name: bigquerydatasetsample
      spec:
        defaultTableExpirationMs: 3600000
        description: "BigQuery Dataset Sample"
        friendlyName: bigquerydataset-sample
        location:
    
  3. Aplique o YAML ao cluster.

    kubectl apply --namespace [PROJECT_ID] -f bq-sample.yaml
  4. Use kubectl describe para ver detalhes sobre o conjunto de dados.

    kubectl describe --namespace [PROJECT_ID] bigquerydataset bigquerydatasetsample

O resultado de kubectl describe inclui metadados sobre o status e a propriedade do recurso.

Como excluir o conjunto de dados

Por padrão, após o Config Connector adquirir e gerenciar um recurso, a exclusão do objeto do seu cluster excluirá o recurso. Se você preferir manter o conjunto de dados, defina o deletion-policy do recurso.

Por exemplo, a exclusão do manifesto que adquiriu bigquerydataset-sample excluirá o conjunto de dados do BigQuery.

  1. Exclua o conjunto de dados bigquerydataset-sample com kubectl delete.

    kubectl delete --namespace [PROJECT_ID] -f bq-sample.yaml

    O resultado de kubectl confirma a exclusão. bigquerydataset.bigquery.cnrm.cloud.google.com "bigquerydatasetsample" deleted

  2. Use bq para confirmar que o conjunto de dados não existe mais.

    bq show [PROJECT_ID]:bigquerydatasetsample

    O resultado do comando inclui Not Found.

Como manter recursos após a exclusão

...
metadata:
  annotations:
    cnrm.cloud.google.com/deletion-policy: abandon
...

Por exemplo, o YAML para o conjunto de dados do BigQuery descrito anteriormente, incluindo a política de exclusão abandon, está abaixo:

apiVersion: bigquery.cnrm.cloud.google.com/v1beta1
  kind: BigQueryDataset
  metadata:
    name: bigquerydatasetsample
    annotations:
      cnrm.cloud.google.com/deletion-policy: abandon
  spec:
    defaultTableExpirationMs: 3600000
    description: "BigQuery Dataset Sample"
    friendlyName: bigquerydataset-sample
    location: US

A seguir