
O Docker Engine oferece suporte a um sistema de plug-in que permite adicionar funcionalidade extra ao tempo de execução do contêiner. Plug-ins para novos drivers de armazenamento, pilhas de rede e sistemas de registro estão disponíveis gratuitamente.
As versões modernas do Docker Engine incluem tudo que você precisa para gerenciar plug-ins dentro da CLI. Estamos nos concentrando neste sistema de plug-in “gerenciado” neste guia. Você deve instalar e manter manualmente os plug-ins que usam o sistema de plug-ins legado.
Tudo sobre plugins
Os plug-ins estendem o Docker Engine com novos recursos que são muito específicos para serem enviados com a instalação geral. Você normalmente não interage diretamente com os plug-ins. Depois que um plug-in é instalado, você pode fazer referência aos recursos que ele fornece ao executar comandos Docker existentes.
Existem três tipos principais de plug-ins:
- Exploração madeireira - Esses plug-ins adicionam novos drivers de registro, permitindo que você armazene registros em locais fora do Docker Engine e de sua máquina host.
- Rede - Os plug-ins de rede podem adicionar suporte para novos tipos de rede e funcionalidades relacionadas.
- Volume - Os plug-ins de armazenamento trazem sistemas de arquivos e drivers de volume adicionais para o Docker, oferecendo mais opções para dados persistentes.
Plug-ins com recursos fora dessas áreas principais também estão disponíveis. Os plug-ins são de autoria de fornecedores da comunidade; você pode escrever o seu próprio usando a API de plug-ins públicos e o Go SDK.
Os plug-ins são distribuídos por meio do Docker Hub. Você pode encontrar os plug-ins disponíveis indo para a página Explorar e selecionando a guia Plug-ins na parte superior. Mais de 600 plug-ins estão disponíveis atualmente.

Se você escrever seu próprio plug-in, poderá enviá-lo ao Docker Hub com o docker plugin push comando. Isso funciona de forma semelhante a enviar uma imagem para o registro público. Você precisa correr docker plugin create primeiro para converter o manifesto e o sistema de arquivos do seu plugin em um pacote pronto para envio. Você pode obter mais informações sobre a criação de plug-ins nos documentos do Docker.
Instalando um Plugin
Os plug-ins são instalados com o docker plugin install comando. Isso aceita o nome de um plug-in Docker Hub como seu argumento:
docker plugin install store/example/example-plugin:version
As referências de plug-ins parecem referências de imagens que começam com store/. Os mesmos princípios de marcação se aplicam ao especificar a versão do plugin a ser instalado. Ao contrário das imagens, você não pode omitir a versão para puxar automaticamente o latest marcação.

Você pode encontrar o número da versão de um plug-in e copiar um comando de instalação pronto para execução clicando no botão “Instruções de configuração” em sua página Docker Hub. Os plug-ins gratuitos permitirão que você prossiga para uma nova tela com a caixa normal de copiar e colar no canto superior direito. Execute o comando em seu terminal para iniciar a instalação do plugin.

Os plug-ins geralmente solicitam acesso a privilégios de host para que possam fornecer sua funcionalidade. Por exemplo, um plug-in de rede precisará ter acesso ao Docker host rede para que possa conectar novos recursos. Confirme o prompt de permissão digitando y e pressionando enter para completar a instalação. Você pode pular o prompt adicionando o --grant-all-permissions sinalizar para o seu install comando; isso é ideal para instalações não interativas, mas arrisca concessões de permissão não intencionais se um plug-in for atualizado com novos recursos.

Os plug-ins são ativados automaticamente após a instalação. Habilitar um plugin permite a execução de scripts de pré-instalação. Use o --disable sinalizar para padronizar o status de desativado de um plugin, deixando-o inerte até ser ativado manualmente mais tarde.
Visualizando Detalhes do Plugin
Uma vez instalado, o seu plugin aparecerá durante a execução docker plugin ls:
docker plugin ls

Informações mais detalhadas sobre um único plugin podem ser obtidas no docker inspect comando. Isso aceita um ID ou tag de plug-in e exibe JSON detalhado que descreve o manifesto do plug-in:
docker inspect eccffc

Instalação offline
O Docker CLI não tem uma maneira integrada de instalar plug-ins offline. No entanto, você pode adicionar plug-ins a uma instalação do Docker sem ar, instalando-os primeiro em um cliente em rede e, em seguida, copiando os arquivos do plug-in para o sistema off-line.

Você encontrará plug-ins instalados dentro do /var/lib/docker/plugins diretório em seu host. Cada plugin obtém seu próprio subdiretório nomeado com seu ID. Esses IDs são visíveis na saída do docker plugin ls comando.
Habilitando e desabilitando plug-ins
Os plug-ins podem ser ativados ou desativados. Você verá o status atual na última coluna do ls saída. Um plugin desabilitado não será carregado, então funcionará como se não estivesse instalado.
Use o docker plugin enable e docker plugin disable comandos para alterar o status de um plugin. Forneça o ID de um de seus plug-ins instalados como o único argumento do comando:
docker plugin enable eccffc
Você pode ser impedido de desativar um plug-in se ele for usado ativamente pela configuração do Docker Engine ou por um de seus contêineres. Adicionando o -f O sinalizador forçará a desativação do plug-in, mas deve ser usado com moderação, pois você corre o risco de saídas indesejadas do contêiner.
Os plug-ins são desinstalados com o docker plugin rm comando. Forneça o ID ou nome de um plug-in para removê-lo completamente do Docker. rm tem os mesmos comportamentos que disable ao lidar com plug-ins usados ativamente e subsequentemente remoções forçadas.
Alterando as configurações do plugin
O sistema de plug-ins do Docker inclui um mecanismo integrado para que os autores do plug-in exponham configurações personalizáveis. Como usuário, você pode alterar essas configurações por meio do docker plugin set comando:
docker plugin set example-plugin setting-key=new-value
Substituir example-plugin com o ID ou nome do plugin que você está almejando. O valor do plugin setting-key configuração será atualizada para new-value.

As configurações disponíveis variam naturalmente de plug-in para plug-in. Eles devem ser documentados na descrição do plug-in no Docker Hub. A Docker CLI não tem um comando integrado para visualizar todas as configurações disponíveis para um plug-in, mas elas aparecem em docker plugin inspect saída. Procure o Settings campo na representação JSON de um plugin; conterá objetos com Name e Settable campos para opções que você pode alterar por meio da CLI.
Atualizando Seus Plugins
Os plug-ins são atualizados com o docker plugin update comando. Como os outros comandos, ele recebe um ID de plugin ou tag como argumento.
A atualização de um plug-in baixará e instalará a versão mais recente disponível no Docker Hub. Se você já estiver com a versão mais recente, o comando reinstalará a versão atual. Você será solicitado a conceder ao plug-in todos os novos privilégios de que ele requer. O --grant-all-permissions sinalizador é aceito para ignorar o prompt em ambientes onde a entrada interativa não é viável.
Não há como atualizar todos os plug-ins em seu sistema com um comando. É melhor você se inscrever para anúncios de lançamento dos fornecedores de seus plug-ins e, em seguida, aplicar atualizações à sua instalação assim que estiverem disponíveis. Isso garantirá que seus plug-ins permaneçam seguros e com suporte.
Resumo
O ecossistema de plug-ins do Docker permite adicionar funcionalidades adicionais ao Docker Engine. Os plug-ins residem no Docker Hub e podem ser instalados a partir do seu terminal. A CLI incorpora um atualizador de plug-in, mas funciona apenas com um único plug-in de cada vez, não com o catálogo inteiro.
Agora que você sabe como usar e gerenciar plug-ins, pode começar a navegar no Docker Hub para encontrar opções para aprimorar seu fluxo de trabalho. O plug-in Elastic Logging transmite logs de contêiner do Docker para um cluster de pilha Elastic, o vSphere for Docker permite que você use o armazenamento VMWare vSphere para seus volumes persistentes e o Weave Net traz rede criptografada multicast para o Docker. Se você não encontrar o que precisa, use a API de plug-in para tentar escrever sua própria solução que você possa publicar para a comunidade mais ampla por meio do Hub.



