Esta página foi traduzida pela API Cloud Translation.

Exporte e importe recursos para o Config Connector

Esta página descreve o comando config-connector export e como usá-lo para exportar Google Cloud recursos para ficheiros YAML, que pode importar posteriormente para o Config Connector. Se já tiver acesso ao ficheiro YAML do recurso, siga os passos em Gerir e eliminar recursos para adquirir o recurso.

Limitações

Nem todos os recursos suportam o comando export. Para obter uma lista dos recursos compatíveis, execute config-connector print-resources.

Antes de começar

Instale a ferramenta de CLI config-connector.
Para simplificar os comandos, defina o seu espaço de nomes predefinido executando o seguinte comando:
```
kubectl config set-context --current --namespace NAMESPACE_NAME
```
Substitua NAMESPACE_NAME pelo nome do seu espaço de nomes.
Obtenha o nome completo do recurso do recurso que quer exportar. Se não souber o nome completo do recurso, pode encontrá-lo com um dos seguintes métodos:
- Use o Cloud Asset Inventory para pesquisar um recurso.
- Use o comando describe ou list para o recurso, por exemplo, gcloud pubsub topics describe sample-topic --format "value(name)".
- Consulte a documentação do produto do recurso para ver um guia sobre como obter o ID do recurso, por exemplo, Obter um ID do recurso do Cloud Key Management Service.

Exporte um recurso

Pode usar a config-connectorferramenta de CLI para exportar um recurso existente para um ficheiro YAML.

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

config-connector export RESOURCE_ID

Substitua RESOURCE_ID pelo nome completo do recurso que quer exportar.

O comando produz o recurso no formato YAML que pode ser usado pelo Config Connector. O resultado deve ser semelhante ao seguinte exemplo:

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

Importe um recurso para o Config Connector

Depois de ter o ficheiro YAML para o recurso que quer que o Config Connector adquira, conclua os seguintes passos:

Transmita o seu recurso para o Config Connector executando o seguinte comando:
```
config-connector export RESOURCE_ID | kubectl apply -f -  --namespace NAMESPACE
```
Substitua NAMESPACE pelo espaço de nomes a partir do qual o Config Connector gere os recursos.
Confirme que o Config Connector está a gerir o recurso executando o seguinte comando:
```
kubectl describe RESOURCE_TYPE RESOURCE_NAME
```
Substitua o seguinte:
- RESOURCE_TYPE: o tipo de recurso, por exemplo, pubsubtopic.
- RESOURCE_NAME: o nome do recurso. Não tem de ser o nome do recurso completo.

Depois de o Config Connector adquirir o recurso, pode gerir esse recurso seguindo os passos em Gerir e eliminar recursos.

`config-connector` Campos opcionais da ferramenta de CLI

Quando executar o comando config-connector export, pode 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 ficheiro, o resultado contém toda a saída do comando; quando é um diretório, o diretório contém um novo ficheiro para cada recurso na saída.
--oauth2-token: um token OAUTH2 como a Google Cloud identidade. Por predefinição, o config-connector usa as credenciais predefinidas da CLI Google Cloud.
--iam-format: especifica o tipo de recursos do IAM gerados com a sua exportação. As opções são policy (predefinição), policymember ou none.
--filter-deleted-iam-members: especifica se os diretores do IAM eliminados devem ser filtrados. As opções são true ou false. O valor predefinido é false.
--verbose: ativa o registo verboso.

O que se segue?

Leia sobre como o Config Connector adquire recursos Google Cloud existentes.
Saiba mais sobre os recursos que o Config Connector suporta.