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 do Stackhero!

Stackhero oferece uma solução PHP cloud pronta a usar que proporciona uma série de benefícios, incluindo:

• Implemente a sua aplicação em segundos com um simples git push.
• Utilize o seu próprio nome de domínio e beneficie da configuração automática de certificados HTTPS para uma segurança reforçada.
• Desfrute de tranquilidade com backups automáticos, atualizações com um clique, e uma tarifação simples, transparente e previsível.
• Obtenha performance ótima e segurança robusta graças a uma VM privada e dedicada.

Poupe tempo e simplifique a sua vida: só leva 5 minutos para experimentar a solução de PHP cloud hosting do Stackhero!

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