Os contextos no Docker CLI fornecem um mecanismo simplificado para interagir com vários endpoints do Docker. Você pode configurar contextos para cada um dos seus hosts e alternar entre eles rapidamente.

Quando um contexto está ativo, o Docker direcionará todos os seus comandos para esse host. Se você usa principalmente uma instalação Docker local, mas às vezes precisa iniciar contêineres na produção, os contextos do Docker são uma opção disponível para você.

Qualquer endpoint válido do Docker pode ser transformado em um contexto. Você pode conectar instalações regulares do Docker Engine, clusters Docker Swarm e clusters Kubernetes na nuvem. Cada contexto armazenado contém todas as informações de conexão do host referenciado.

Criando um Contexto

Contextos são gerenciados com o docker context comando. Você cria novos contextos usando docker context create. Você deve fornecer um nome para seu contexto, bem como sua configuração de terminal.

Veja como criar um contexto que se conecta a um soquete Docker exposto sobre TCP em um host remoto:

docker context create remote-host --docker host=tcp:///my-remote-host:2735

Os contextos usam o Docker Swarm como orquestrador de contêineres padrão. Você pode definir isso explicitamente usando um sinalizador:

docker context create remote-host 
 --default-stack-orchestrator=swarm 
 --docker host=tcp:///my-remote-host:2735

Para criar uma conexão com o Kubernetes, altere o tipo de orquestrador. Você também deve adicionar o --kubernetes sinalizar e especificar o caminho para um arquivo de configuração do Kubernetes:

docker context create kubernetes-host 
 --default-stack-orchestrator=kubernetes 
 --kubernetes config-file=/home/username/.kube/config 
 --docker host=unix:///var/run/docker.sock

Seleção de contextos

O contexto ativo é alternado usando docker context use. Passe o nome do contexto que deseja ativar.

docker context use remote-host

Todos os comandos CLI subsequentes serão executados usando o ponto de extremidade fornecido pelo novo contexto. O contexto ativo persistirá automaticamente até que você o altere. Para mudar para um contexto diferente, execute docker context use novamente. Você pode reverter para o contexto padrão com seu soquete Docker local passando default como o nome do contexto.

Você sempre pode substituir o contexto selecionado adicionando o --context sinalizar para qualquer comando do Docker:

docker run ubuntu:latest --context remote-host

O DOCKER_CONTEXT variável de ambiente também funciona como uma alternativa para o --context bandeira. Qualquer um dos mecanismos facilita uma mudança temporária para um contexto diferente sem fazer você executar e reverter um docker context use comando.

Usando o DOCKER_HOST a variável de ambiente também substituirá o contexto ativo. Esta variável força o Docker a usar um determinado endpoint do daemon em vez daquele fornecido pelo contexto.

Você pode inspecionar o contexto ativo executando docker context ls. Este comando lista todos os contextos disponíveis em sua configuração CLI. O contexto ativo é destacado com um asterisco. Para excluir um contexto, execute docker context rm, fornecendo o nome do contexto. Não é possível deletar o default contexto.

Sincronizando Contextos entre Máquinas

Os arquivos de contexto são armazenados no diretório de configuração do Docker CLI. Isso geralmente é $HOME/.docker no Linux. Você encontrará seus contextos no contexts subdiretório. Cada contexto obtém sua própria pasta nomeada com um hash exclusivo. Dentro, você encontrará um meta.json arquivo que descreve o contexto. Apenas contextos criados têm arquivos armazenados no disco. O default contexto herda as configurações de sua configuração do daemon do Docker.

Se você deseja sincronizar a configuração do contexto, você pode fazer backup do contexts pasta para movê-lo para outra máquina. Você pode usar uma transferência Rsync ou um repositório Git para simplificar as atualizações regulares. Vincular simbolicamente a pasta a um compartilhamento de rede também pode ser uma opção, dependendo de seus requisitos.

O Docker também permite exportar e importar contextos por meio da CLI:

docker context export my-context

Isso criará um my-context.dockercontext arquivo em seu diretório de trabalho. O arquivo inclui o meta.json conteúdo, bem como algumas informações extras, como o nome do contexto. Transfira este arquivo para outra máquina e execute docker context import my-context.dockercontext para carregar a configuração do contexto.

Como alternativa, você pode exportar um arquivo de configuração autônomo do Kubernetes para contextos do Kubernetes:

docker context export kubernetes-context --kubeconfig

Isso produzirá um arquivo “kubeconfig” regular compatível com as ferramentas do ecossistema Kubernetes, como kubectl. A capacidade de adquirir um arquivo kubeconfig de um contexto do Docker melhora a interoperabilidade do conjunto de ferramentas. Nada dentro do arquivo será específico para a Docker CLI.

Se você precisar editar um contexto, use o docker context update comando. Isso aceita as mesmas sinalizações que docker context create. Se estiver fazendo atualizações em massa, você pode editar o meta.json arquivos para manipular diretamente seus contextos. Você pode inspecionar um contexto meta.json arquivo da CLI com docker context inspect my-context.

Conclusão

Os contextos do Docker são úteis quando você precisa implantar contêineres em vários ambientes independentes. Você pode configurar contextos para seu soquete Docker local, um servidor de teste de equipe compartilhado e seu servidor Kubernetes de produção.

O Docker tem suporte integrado para as nuvens de contêiner do Microsoft Azure e Amazon ECS, que também podem ser adicionados como contextos. Não há limite para o número de contextos que você pode criar, então você tem boa versatilidade ao mover-se entre seus hosts.

Provavelmente, o maior problema funcional com contextos é a possibilidade de executar acidentalmente um comando no contexto errado. Se você esqueceu que está no seu production contexto, execução docker rm database-container poderia ter consequências devastadoras. Em caso de dúvida, corra docker context ls primeiro para verificar o que você selecionou.

Adicione ao Google Notícias