PHP: Configurar as chaves SSH

Esta documentação faz parte do guia Implementar com GitHub Actions. Consulte o guia completo aqui: Como implementar o seu código PHP utilizando o GitHub Actions.

👋 Bem-vindo à documentação da Stackhero!

A Stackhero disponibiliza uma plataforma PHP cloud concebida para implementações rápidas e fiáveis:

• Implemente a sua aplicação PHP em produção em segundos com um simples git push.
• Utilize o seu próprio domínio, com certificados HTTPS automáticos configurados para si. Não são necessários passos manuais.
• Conte com backups automáticos, atualizações com um clique e preços claros e previsíveis. A Stackhero trata destes detalhes, para que se possa concentrar no seu código.
• Beneficie de elevada performance e segurança numa infraestrutura privada e dedicada, construída especificamente para as suas aplicações.

Torne o seu fluxo de trabalho mais eficiente e poupe tempo. Começar a utilizar o PHP cloud hosting da Stackhero demora apenas alguns minutos.

As chaves SSH são o método recomendado para permitir que o GitHub Actions se ligue de forma segura ao seu serviço PHP durante a implementação. Neste guia, irá criar um par de chaves SSH exclusivo para este fim.

Gerar as chaves SSH

Para gerar novas chaves SSH, execute este comando no seu computador:

ssh-keygen -C "" -f /tmp/ssh_key -N ""

Definir a chave pública

De seguida, obtenha a chave pública executando:

cat /tmp/ssh_key.pub

Aceda ao seu dashboard Stackhero e selecione o seu serviço PHP "Production". Clique em "Configure" e siga estes passos:

1. Em SSH public keys, clique em "Add a public key".
2. Defina a Description como "GitHub Action".
3. Cole a chave pública que acabou de obter no campo Key.

Obter definições do serviço

Definir a chave privada

Agora, adicione a chave privada ao seu projeto GitHub para que possa ser utilizada durante a implementação:

• Vá a Settings, selecione Environments e clique em New environment.

  Configurar ambientes GitHub

• No campo Name, introduza "production" e confirme.

  Definir o ambiente

• Clique no botão No restriction e selecione Selected branches and tags.

  Definir restrições do ambiente

• Clique em Add deployment branch or tag rule, introduza "production" no campo Name pattern e clique em Add rule.

  Definir ramo do ambiente Definir ramo do ambiente

• Na secção Environment secrets, clique em Add secret.

  Adicionar secret

Obtenha a chave privada que gerou anteriormente executando:

cat /tmp/ssh_key

Nas definições de ambiente do GitHub:

• Em Name, introduza STACKHERO_SSH_PRIVATE_KEY e cole a sua chave privada no campo Value.

  Definir o secret da chave privada SSH

• Na secção Environment variables, clique em Add variable.

  Definir variáveis

• Em Name, introduza STACKHERO_ENDPOINT e cole o endpoint do seu serviço PHP no campo Value. Pode encontrar este endpoint no seu dashboard Stackhero.

  Definir a variável endpoint

Se personalizou o nome de domínio do seu serviço, utilize a versão personalizada em vez de <XXXXXX>.stackhero-network.com.

Apagar as chaves geradas

Por motivos de segurança, é aconselhável remover as chaves SSH geradas do seu computador após a configuração:

rm /tmp/ssh_key /tmp/ssh_key.pub