Pular para o conteúdo principal

BitBucket

Nesta seção, você encontra os passos para integrar o SCM com o provedor BitBucket usando o StackSpot Workflow.


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 os comandos a seguir:

  1. Se estiver com um Workspace ativo, use o comando a seguir para sair do Workspace:
stk exit workspace
  1. Após sair do Workspace, execute o Workflow com o comando a seguir:
stk run workflow stackspot-core/stackspot-setup-scm@3

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

Passo 3. Responda as seguintes perguntas no terminal:

  • Organization/Workspace Name: escreva o nome do seu usuário do BitBucket.
  • Repository Name: escreva o nome do seu repositório.
  • Project Name: escreva o nome do seu projeto.

Se você ainda não tem um projeto, acesse o menu da sua conta no BitBucket e clique em 'Create' > 'Create a project'.

  • Personal Access Token: informe o Personal Access Token gerado no BitBucket.
  • The repository to setup scm already exists? (Y/n): para informar se o repositório da configuração do SCM já existe, responda 'Y' para sim e 'n' para não.
  • Want to do the setup in main branch or create a pull request? (Y/n): responda 'Y' para sim e 'n' para não. Ao escolher 'Y' (sim), informe em Target branch a branch usada para criar o pull request ou informe 'n' (não) para manter a configuração na branch 'main'.

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 e você pode conferi-las na seção 'Repository variables'.

Agora você precisa integrar o SCM no Portal da StackSpot. Para isso, siga os passos a seguir:

Integrar o BitBucket com a StackSpot

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

Passo 2. Clique na opção 'Organização';

Passo 3. No Portal da Conta, clique em 'EDP' e depois, 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:

Atenção!

Por segurança, credenciais como o Personal Access Token (PAT) são armazenadas de forma criptografada na StackSpot. Após serem salvos, não é possível consultar ou visualizar novamente essas informações pela plataforma.

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 vai gerenciar o acesso ao GitHub via PAT (Personal Access Token) ou GitHub App.
  • Desabilitado: a empresa vai gerenciar o acesso ao GitHub.
Informação Adicional

Ao habilitar este botão, os membros da sua Conta terão que configurar o próprio Acesso de SCM.

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.