Exportar e importar recursos para o Config Connector

Nesta página, descrevemos o comando config-connector export e como usá-lo para exportar recursos Google Cloud para arquivos YAML, que podem ser importados posteriormente para o Config Connector. Se você já tiver acesso ao arquivo YAML do recurso, siga as etapas em Gerenciar e excluir recursos para adquirir o recurso.

Limitações

Nem todos os recursos são compatíveis com o comando export. Para conferir uma lista de recursos com suporte, execute config-connector print-resources.

Antes de começar

  1. Instale a ferramenta CLI config-connector.
  2. Para simplificar os comandos, defina o namespace padrão executando o seguinte comando: 
    kubectl config set-context --current --namespace NAMESPACE_NAME
     Substitua NAMESPACE_NAME pelo nome do namespace.
  3. Encontre o nome completo do recurso que você quer exportar. Se você não souber o nome completo do recurso, tente encontrá-lo com um dos seguintes métodos:

Exportar um recurso

É possível usar a ferramenta CLI config-connector para exportar um recurso para um arquivo YAML.

Para exportar um recurso para um arquivo YAML, execute o seguinte comando:

config-connector export RESOURCE_ID

Substitua RESOURCE_ID pelo nome completo do recurso que você quer exportar.

O comando gera o recurso no formato YAML, que pode ser usado pelo Config Connector. A saída será semelhante ao exemplo a seguir:

apiVersion: pubsub.cnrm.cloud.google.com/v1beta1
kind: PubSubTopic
metadata:
  annotations:
    cnrm.cloud.google.com/project-id: my-example-project
  name: sample-topic

Importar um recurso para o Config Connector

Depois de ter o arquivo YAML do recurso que você quer que o Config Connector adquira, siga estas etapas:

  1. Transmita seu recurso para o Config Connector executando o seguinte comando:

    config-connector export RESOURCE_ID | kubectl apply -f -  --namespace NAMESPACE

    Substitua NAMESPACE pelo namespace em que o Config Connector gerencia recursos.

  2. Confirme se o Config Connector está gerenciando o recurso executando o seguinte comando:

    kubectl describe RESOURCE_TYPE RESOURCE_NAME

    Substitua:

    • RESOURCE_TYPE: o tipo de recurso, por exemplo, pubsubtopic.
    • RESOURCE_NAME: o nome do recurso. Ele não precisa ser o nome completo do recurso.

Depois que o Config Connector adquirir o recurso, você poderá gerenciá-lo seguindo as etapas em Gerenciar e excluir recursos.

Campos opcionais da ferramenta CLI config-connector

Ao executar o comando config-connector export, é possível transmitir os seguintes campos opcionais:

config-connector export RESOURCE_NAME \
    --output FILENAME \
    --oauth2-token TOKEN \
    --iam-format [policy | policymember | none] \
    --filter-deleted-iam-members [true | false] \
    --verbose
  • --output: um caminho de saída opcional que desativa a saída padrão. Quando um arquivo é gerado, o resultado contém toda a resposta ao comando. Quando um diretório é gerado, ele contém um novo arquivo para cada recurso na resposta.
  • --oauth2-token: um token OAUTH2 como a identidade Google Cloud . Por padrão, o config-connector usa as credenciais padrão da Google Cloud CLI.
  • --iam-format: especifica o tipo de saída dos recursos do Cloud IAM com sua exportação. As opções são policy (padrão), policymember ou none.
  • --filter-deleted-iam-members: especifica se você quer filtrar as principais do IAM excluídas. As opções são true ou false. O valor padrão é false.
  • --verbose: ativa o registro detalhado.

A seguir