Importar projeto Atlas para o Atlas Kubernetes Operator

Nesta página

Visão geral

Parâmetros
Compatibilidade
Exemplos

Se você tiver deployments Kubernetes existentes e desejar começar a utilizar o Atlas Kubernetes Operator, poderá utilizar os comandos do Atlas CLI atlas kubernetes config generate ou atlas kubernetes config apply para exportar projeto Atlas, deployments e trigger de banco de dados.

Ambos os comandos permitem a você exportar sua configuração em um formato compatível com o Atlas Kubernetes Operator para utilizar no cluster Kubernetes ou OpenShift no qual o Atlas Kubernetes Operator é executado. O comando atlas kubernetes config generate consegue isso criando uma configuração formatada noYAMLpara o stdout do seu terminal, enquanto o comando atlas kubernetes config apply armazena a configuração na memória e a envia diretamente para um cluster Kubernetes de destino.

Visão geral

Ambos os comandos geram uma configuração formatada do .yamlque inclui os seguintes recursos do Atlas Kubernetes Operator:

Parâmetros

O comando usa os seguintes parâmetros:

Parâmetro	Descrição	necessidade
`--projectId`	Sequência hexadecimal única de 24 dígitos que identifica seu projeto. Se omitido, o padrão é o valor `projectId` no arquivo de configuração `atlascli` .	Obrigatório.
`--clusterName`	Uma lista separada por vírgulas de rótulos legíveis por humanos que identificam os clusters a serem exportados. Estes devem ser agrupamentos no projeto especificado no parâmetro `projectId` . Se omitido, o comando exporta todos os clusters no projeto especificado.	Opcional.
`--includeSecrets`	Sinalizador que preenche uma entrada no arquivo de configuração para um segredo de credenciais do Atlas. Se omitido, o comando cria um segredo, mas não o preenche com dados. O segredo é renderizado como texto simples.	Opcional.
`--targetNamespace`	Namespace Kubernetes para o qual exportar os recursos. O comando preenche o campo `metadata.namespace` de cada entidade Atlas exportada com o valor deste parâmetro.	Obrigatório.
`--operatorVersion`	Versão do Atlas Kubernetes Operator para a qual exportar seus arquivos. Se omitido, o comando exporta arquivos compatíveis com o Atlas Kubernetes Operator v1.5.1.	Opcional.

O comando usa os seguintes parâmetros:

Parâmetro	Descrição	necessidade
`--projectId`	Sequência hexadecimal única de 24 dígitos que identifica seu projeto. Se omitido, o padrão é o valor `projectId` no arquivo de configuração `atlascli` .	Obrigatório.
`--orgId`	string hexadecimal exclusiva de 24dígitos que identifica a organização Atlas para registrar o projeto . Se omitido, o padrão será o valor `orgId` em seu arquivo de configuração `atlascli` ou sua variável de ambiente `ORGID` .	Opcional.
`--clusterName`	Uma lista separada por vírgulas de rótulos legíveis por humanos que identificam clusters a serem exportados. Estes devem ser clusters no projeto especificado no parâmetro `projectId` . Se omitido, o comando exporta todos os clusters no projeto especificado.	Opcional.
`--targetNamespace`	Namespace Kubernetes para o qual exportar os recursos. O comando preenche o campo `metadata.namespace` de cada entidade Atlas exportada com o valor deste parâmetro.	Obrigatório.
`--operatorVersion`	Versão do Atlas Kubernetes Operator para a qual exportar seus arquivos. Se omitido, o comando exporta arquivos compatíveis com o Atlas Kubernetes Operator v1.5.1.	Opcional.
`--kubeContext`	`Kubeconfig` contexto a ser usado para conexão com o cluster.	Obrigatório
`--kubeconfig`	Caminho para seu arquivo `kubeconfig` .	Obrigatório

Compatibilidade

atlascli exporta configurações do Atlas em um formato que depende da versão do Atlas Kubernetes Operator. A tabela a seguir descreve quais versões do atlascli suportam quais versões do Atlas Kubernetes Operator:

`atlascli` Versão	Versões do Atlas Kubernetes Operator
1.4.0	1.5.0

Exemplos

Os exemplos a seguir pressupõem um projeto chamado sampleProject, com clusters chamados sample1, sample2 e sample3, um ID do projeto de 63500d1139dd494b92fe4376 e um namespace de destino de sampleNamespace.

Para exportar todo o projeto, incluindo todos os sistemas do Atlas e segredos com credenciais, execute o seguinte comando:

atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \
--includeSecrets --targetNamespace=sampleNamespace

Para exportar duas implantações específicas do Atlas do projeto sem credenciais secretas, execute o seguinte comando:

atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \
--clusterName=sample1,sample2 --targetNamespace=sampleNamespace

Nos exemplos de comando anteriores, você pode aplicar a configuração gerada ao seu cluster Kubernetes ou OpenShift canalizando a saída para o comando kubectl apply . O exemplo de comando a seguir ilustra isso:

atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \
--clusterName=sample1,sample2 --targetNamespace=sampleNamespace \
| kubectl apply -f -

Alternativamente, você pode salvar a configuração gerada redirecionando stdout para um arquivo .yaml . O comando a seguir importa um único sistema Atlas do projeto sem credenciais secretas e salva a saída em myAtlasProject.yaml.

atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \
--clusterName=sample3 --targetNamespace=sampleNamespace \
> myAtlasProject.yaml

Aplicando a configuração

Para aplicar a configuração gerada ao seu cluster Kubernetes ou OpenShift nesse cenário, passe o arquivo .yaml como argumento para o comando kubectl apply .

kubectl apply -f myAtlasProject.yaml

Para exportar todo o projeto, execute o seguinte comando:

atlas kubernetes config apply --projectId=63500d1139dd494b92fe4376 \
--targetNamespace=sampleNamespace

Para exportar dois sistemas Atlas específicos do projeto, execute o seguinte comando:

atlas kubernetes config apply --projectId=63500d1139dd494b92fe4376 \
--clusterName=sample1,sample2 --targetNamespace=sampleNamespace
In contrast to ``atlas kubernetes config generate``, this
command directly applies the generated configuration without
any further manual operation on your part.

Voltar

Equipes

Federação de Dados