Pular para o conteúdo principal

BitBucket

Nesta seção, você encontra como integrar o SCM com o provedor BitBucket.


Para integrar o

SCM
com a StackSpot, o primeiro passo é criar um repositório próprio da sua organização para as pipelines. Desta forma quando definidas, você poderá acioná-las remotamente via API informando os dados de entrada para cada fluxo.

Pré-Requisito

  • Ter uma conta premium no BitBucket.
  • Habilitar a verificação de duas etapas dentro da sua conta no BitBucket (two-step verification). Para fazer isso na sua conta do BitBucket, acesse:
    • 'Configuração Pessoal do BitBucket > Verificação de duas etapas' > 'Habilitar'
  • Criar repositório/pipelines. Para integrar o SCM com a StackSpot, você precisa criar um repositório para gerar Pipelines.

Configurar suas chaves de consumidor OAuth do BitBucket Workspace

Passo 1. No BitBucket, clique em "Workspace Settings > OAuth consumers".

Passo 2. Clique em 'Add consumer'. Em seguida, preencha os seguintes campos obrigatórios:

  • Name;
  • Callback URL e/ou URL;
  • Habilite a opção "This is a private consumer";
  • Selecione os seguintes campos em "Permissions":

Projects
[x] Write
[x] Admin

Repositories
[x] Write
[x] Admin

Pipelines
[x] Edit variables

Ao final, clique no botão "Save".

Informação Adicional

Você pode excluir a configuração dos consumidores OAuth após terminar a configuração das pipelines.

Configurar as pipelines automaticamente (Recomendado)

Os passos a seguir são feitos via STK CLI

Passo 1. Execute o comando a seguir:

stk run action stackspot-core/setup-scm

Passo 2. O terminal pergunta qual é o seu provedor SCM. Selecione a opção BitBucket.

Passo 3. Responda as seguintes perguntas no terminal:

  • Project key: Adicione o nome do seu projeto no BitBucket.
  • Repository Name: Escreva o nome do seu repositório.
  • Workspace Name: Escreva o nome do seu usuário do BitBucket.
  • Client Key: Adicione a chave que está dentro de 'Workspace settings > 'OAuth consumers'.
  • Client Secret: Adicione a secret que está dentro de 'Workspace settings > 'OAuth consumers', logo depois do 'Client Key'.
Informação Adicional

Se o repositório informado existir e nele também existir a branch main, um Pull Request será criado para a main. Se o repositório não existir, a Action cria o repositório e a branch main.

Se você ainda não tem um projeto, acesse o menu localizado no lado superior direito da página da sua conta BitBucket e clique em 'Create' > 'Create a project'.

A Action foi executada. Agora as pipelines estão habilitadas no seu repositório.

Passo 4. Confira o seu repositório no BitBucket, dentro da seção 'Repository details'. Você verá as pipelines já configuradas. As variáveis também já foram criadas, você pode conferir na seção 'Repository variables'.

Agora, você precisa integrar o SCM no Portal da StackSpot. Siga os próximos passos.

Integrar o BitBucket com a StackSpot

Passo 1. Acesse diretamente link do Portal da Conta; ou após fazer login no Portal StackSpot, clique no seu avatar de perfil;

Passo 2. Selecione a opção 'Organização' no menu exibido;

Passo 3. No menu principal do Portal da Conta, selecione o produto StackSpot EDP e clique em ’SCM’. Em seguida, clique no botão Configurar Integração SCM’;

Passo 4. No campo Select a provider, selecione BitBucket;

Passo 5. Em Método de autenticação, selecione a opção PAT (Personal Access Token) e preencha os seguintes campos:

Passo 6. Em Configuração de Workflow, escolha como a organização deseja gerenciar o acesso ao SCM, para isso, desabilite a opção 'A organização vai gerenciar o acesso ao SCM via User PAT?':

  • Habilitado: O usuário irá gerenciar o acesso ao GitHub via PAT (Personal Access Token) ou GitHub App.
  • Desabilitado: A empresa irá gerenciar o acesso ao GitHub.
Informação Adicional

Ao habilitar este botão, os membros da sua conta terão que configurar o Acesso de SCM individual deles.

Passo 7. No campo URL do Workflow, insira a URL do repositório criado com as pipelines para a StackSpot identificar onde o seu workflow está configurado. Por exemplo: https://bitbucket.org/my-username/my-repo-runner-actions.

Passo 8. Você será redirecionado para a tela de Review. Confira seus dados e clique em 'Integrar com StackSpot'.

Pronto, sua configuração está completa.

Esta página foi útil?