stk add plugin

Nesta seção, você encontra mais informações sobre o comando ‘stk add plugin’.

Descrição

O comando stk add plugin é utilizado para adicionar Plugins as Stack já criadas pelo comando stk create stack.

Como funciona?

O comando deve ser executado dentro de uma pasta criada pelo comando stk create stack. Pode receber como parâmetro a URL de um repositório Git de um Plugin ou um caminho para uma pasta de um Plugin criado pelo comando stk create plugin.

Ao usar uma URL de um repositório Git, o Plugin será adicionado à Stack como um submódulo da Stack, ou seja, o Plugin possui um repositório git próprio. Neste caso, um só Plugin pode ser adicionado em mais de uma Stack e as atualizações são feitas no repositório do Plugin. Estas atualizações são refletidas automaticamente em todas as Stacks onde o Plugin foi adicionado.

Ao usar um caminho para uma pasta de um Plugin, o código fonte do Plugin é copiado para dentro do repositório da Stack e passa a fazer parte dela como se tivesse sido criado diretamente na pasta da Stack com o comando stk create plugin. Usando esta opção não há como refletir a atualização do Plugin em mais de uma Stack.

Utilize esta opção caso queira converter um Plugin que foi criado como um submódulo para um Plugin que não será compartilhado entre Stacks.

Você deve executar os comandos abaixo dentro da pasta da Stack:

  • stk add plugin <plugin-repo-url> ou <path-para-pasta-do-plugin> para cada Plugin que você quer adicionar a stack.
  • git push -u origin main para atualizar o repositório da Stack remotamente após adicionar um Plugin.

Parâmetros

Confira a opção disponível no comando:

ParâmetroDescrição
REPO_URL_OR_PATHDefine a URL do repositório Git ou o caminho para a pasta do Plugin a ser adicionado à Stack.

Exemplo

Depois de criar sua Stack, você pode adicionar os Plugins:

  1. Vá para a pasta da Stack que você criou, no exemplo abaixo o nome é ‘my-stack-demo’:
cd my-stack-demo
  1. Depois execute:
stk add plugin [URL do seu repositório ou caminho para a pasta do plugin]
  1. O terminal retorna:
> Verifying "[URL do seu repositório]" plugin git repository...
- Plugin repository is valid.
> Adding "[URL do seu repositório]" plugin to stack...
- "[URL do seu repositório]" added to stack.

Now you can execute 'git push' to publish the plugin added to remote stack repository.
  1. Agora, execute:
ls
  1. O terminal retorna:
stack.yaml
/nome-repositorio-plugin
  1. Agora, execute para atualizar o repositório remoto da Stack com o novo Plugin:
git push

Confira um exemplo abaixo:

Leia também