O Docker é uma plataforma popular para empacotar aplicativos como artefatos distribuíveis independentes. Ele cria imagens que incluem tudo o que você precisa para executar um software específico, como seu código-fonte, dependências de pacotes de terceiros e características de ambiente necessárias.

Como as imagens do Docker podem ser executadas em qualquer lugar onde o Docker esteja instalado, elas são um formato viável para distribuir seus aplicativos CLI. O ecossistema Docker inclui o Docker Hub como um registro público disponível por padrão, oferecendo uma cadeia de ferramentas completa para publicar, atualizar e documentar suas ferramentas.

Veja como você pode usar o Docker para empacotar aplicativos CLI em vez de gerenciadores de pacotes de SO tradicionais e downloads binários autônomos.

Por que usar o Docker para aplicativos CLI?

O Docker pode tornar mais rápido e fácil para os usuários instalarem seu novo utilitário. Eles chegam a docker run your-app em vez de ter que procurar instruções de instalação específicas da plataforma. Não há extração manual de tar arquivos, copiando para pastas do sistema ou PATH edição envolvida.

O software dockerizado também facilita para os usuários selecionar versões diferentes, realizar atualizações e iniciar reversões. Cada versão distinta que você cria deve ter sua própria tag imutável que identifica exclusivamente sua imagem do Docker. Ao contrário dos gerenciadores de pacotes comuns, os usuários podem facilmente executar duas versões de seu software lado a lado iniciando contêineres com base em diferentes tags de imagem.

Outro benefício é a facilidade com que os usuários podem testar seu aplicativo com segurança sem se comprometer a longo prazo com ele. As pessoas podem hesitar em adicionar novos pacotes às suas máquinas para que o software não seja totalmente limpo quando removido. Os contêineres do Docker têm seu próprio sistema de arquivos privado; remover um contêiner não deixa vestígios de sua existência no host. Isso pode incentivar mais usuários a experimentar seu aplicativo.

Uma consequência natural da distribuição Dockerizada é o requisito de que os usuários já tenham o Docker rodando em sua máquina. Hoje em dia, muitos desenvolvedores irão executá-lo como uma coisa natural, então é uma escolha bastante segura de se fazer. Se você estiver preocupado em bloquear usuários que não desejam usar o Docker, ainda poderá fornecer opções alternativas por meio de seus canais de distribuição existentes.

Criando uma imagem do Docker para um aplicativo CLI

As imagens do Docker para aplicativos CLI são um pouco diferentes daquelas usadas para qualquer outro tipo de software. O objetivo é fornecer uma imagem o mais leve possível, ao mesmo tempo em que agrupa tudo o que seu aplicativo precisa para operar.

Geralmente, é melhor começar com uma imagem de base mínima que execute um sistema operacional simplificado como o Alpine. Adicione apenas os pacotes que seu software requer, como sua linguagem de programação, estrutura e dependências.

Duas instruções vitais do Dockerfile para ferramentas CLI são ENTRYPOINT e CMD. Juntos, eles definem o processo de primeiro plano que será executado quando os contêineres forem iniciados a partir de sua imagem. A maioria das imagens de base será padrão para iniciar um shell quando o contêiner for iniciado. Você deve alterar isso para que seu aplicativo seja executado automaticamente, eliminando a necessidade de os usuários executá-lo manualmente dentro do contêiner.

O ENTRYPOINT A instrução Dockerfile define o processo de primeiro plano do contêiner. Defina isso para o executável do seu aplicativo:

ENTRYPOINT ["demo-app"]

O CMD instrução funciona em conjunto com ENTRYPOINT. Ele fornece argumentos padrão para o comando definido no ENTRYPOINT. Argumentos que o usuário fornece ao iniciar o container com docker run irá substituir o CMD definido no Dockerfile.

Um bom uso para CMD é quando você deseja mostrar alguma ajuda básica ou informações de versão quando os usuários omitem um comando específico:

ENTRYPOINT ["demo-app"]
 CMD ["--version"]

Aqui estão alguns exemplos que mostram como essas duas instruções resultam em comandos diferentes sendo executados quando os contêineres são criados:

# Starting a new container from the "demo-app-image:latest" image
 
 # Runs "demo-app --version"
 docker run demo-app-image:latest
 
 # Runs "demo-app demo --foo bar"
 docker run demo-app-image:latest demo --foo bar

Nenhum dos exemplos exige que o usuário digite o demo-app nome executável. É usado automaticamente como o processo de primeiro plano porque é o processo configurado ENTRYPOINT. O comando recebe os argumentos que o usuário deu docker run após o nome da imagem. Quando nenhum argumento é fornecido, o padrão --version é usado.

Essas duas instruções são os blocos de construção fundamentais das imagens do Docker que hospedam as ferramentas da CLI. Você deseja que o executável principal do seu aplicativo seja o processo de primeiro plano padrão para que os usuários não precisem invocá-lo.

Juntar as peças

Aqui está uma imagem do Docker que executa um aplicativo Node.js simples:

#!/usr/local/bin/node console.log("Hello World");
FROM node:16-alpine
 WORKDIR /hello-world
 
 COPY ./ .
 
 RUN npm install
 
 ENTRYPOINT ["hello-world.js"]

A variante baseada em Alpine da imagem base do Node é usada para reduzir o tamanho geral da sua imagem. O código-fonte do aplicativo é copiado para o sistema de arquivos da imagem por meio do COPY instrução. As dependências npm do projeto são instaladas e o hello-world.js script é definido como o ponto de entrada da imagem.

Construa a imagem usando docker build:

docker build -t demo-app-image:latest

Agora você pode executar a imagem para ver Hello World emitido para o seu terminal:

docker run demo-app-image:latest

Neste ponto, você está pronto para enviar sua imagem para o Docker Hub ou outro registro onde ela pode ser baixada pelos usuários. Qualquer pessoa com acesso à imagem poderá iniciar seu software usando apenas a CLI do Docker.

Gerenciando dados persistentes

Dockerizar um aplicativo CLI traz alguns desafios. O mais proeminente deles é como lidar com a persistência de dados. Os dados criados em um contêiner são perdidos quando esse contêiner é interrompido, a menos que sejam salvos em um volume externo do Docker.

Você deve gravar dados em caminhos claramente definidos para os quais os usuários possam montar volumes. É uma boa prática agrupar todos os seus dados persistentes em um único diretório, como /data. Evite usar muitos locais que exigem a montagem de vários volumes. Seu guia de introdução deve documentar os volumes de que seu aplicativo precisa para que os usuários possam configurar a persistência ao criar seu contêiner.

# Run demo-app with a data volume mounted to /data
 docker run -v demo-app-data:/data demo-app-image:latest

Outros possíveis desafios

O problema de montagem reaparece quando seu comando precisa interagir com arquivos no sistema de arquivos do host. Aqui está um exemplo simples de uma ferramenta de upload de arquivos:

docker run file-uploader cp example.txt demo-server:/example.txt

Isso acaba procurando example.txt dentro de o recipiente. Nessa situação, os usuários precisarão vincular a montagem de seu diretório de trabalho para que seu conteúdo esteja disponível para o contêiner:

docker run -v $PWD:/file-uploader file-uploader cp example.txt demo-server:/example.txt

Também é importante pensar em como os usuários fornecerão valores de configuração para seu aplicativo. Se você normalmente lê um arquivo de configuração, lembre-se de que os usuários precisarão montar um em cada contêiner que criarem. Oferecer opções alternativas, como sinalizadores de linha de comando e variáveis ​​de ambiente, pode simplificar a experiência para casos de uso simples:

# Setting the LOGGING_DRIVER environment variable in the container
 docker run -e LOGGING_DRIVER=json demo-app-image:latest

Um outro desafio diz respeito a aplicativos interativos que exigem entrada do usuário. Os usuários precisam passar o -it bandeira para docker run para habilitar o modo interativo e alocar um pseudo-TTY:

docker run -it demo-app-image:latest

Os usuários devem se lembrar de definir esses sinalizadores quando necessário ou seu programa não poderá coletar nenhuma entrada. Você deve documentar os comandos que precisam de um TTY para que os usuários não sejam pegos por erros inesperados.

Esses pontos de discórdia significam que os aplicativos Dockerizados podem se tornar difíceis de manejar se não forem projetados especificamente com a conteinerização em mente. Os usuários obtêm a melhor experiência quando seus comandos são puros, não exigindo interações do sistema de arquivos e configuração mínima. Quando isso for possível, uma simples docker run image-name cumpre o objetivo de instalação e uso sem atrito. Você ainda pode contentorizar softwares mais complexos, mas depende cada vez mais de usuários que tenham um bom conhecimento prático da CLI do Docker e seus conceitos.

Resumo

O Docker não serve apenas para implantações em nuvem e serviços em segundo plano. Também é cada vez mais popular como mecanismo de distribuição para aplicativos de console regulares. Você pode publicar, consumir, executar e manter o software prontamente usando o único docker CLI que muitos profissionais de software já usam no dia-a-dia.

Oferecer uma imagem do Docker pronta para uso para seu aplicativo oferece aos usuários mais opções. Os recém-chegados podem começar com um único comando que configura um ambiente pré-configurado com todas as dependências atendidas. Não há risco de poluir o sistema de arquivos ou ambiente do host do Docker, evitando conflitos com outros pacotes e garantindo a capacidade de reverter para uma lousa limpa, se desejado.

A criação de uma imagem do Docker geralmente não envolve mais do que as rotinas que você já está usando para enviar compilações para diferentes gerenciadores de pacotes do SO. As considerações mais importantes são manter sua imagem o menor possível e garantir que o ponto de entrada e o comando sejam apropriados para seu aplicativo. Isso dará aos usuários a melhor experiência possível ao usar seu software Dockerizado.


Fonte Adicione ao Google Notícias