Usar as implantações do GitHub no WordPress.com

O GitHub Deployments integra seus repositórios do GitHub diretamente ao seu site do WordPress.com, proporcionando um fluxo de trabalho automatizado e controlado por versão para implantar plugins, temas ou alterações completas no site. Este guia trata do processo de configuração e como gerenciar seus repositórios conectados.

Esta funcionalidade está disponível nos sites com os planos WordPress.com Negócios e Commerce. Se você tiver um plano Negócios, certifique-se de ativá-lo. Para sites gratuitos e sites com os planos Pessoal e Premium, faça upgrade do seu plano para acessar essa funcionalidade.

Este vídeo está em inglês.
O YouTube oferece recursos de tradução automática para que você possa assisti-lo no seu idioma:

Para ativar legendas com tradução automática:

1. Reproduza o vídeo.
2. Clique no ícone ⚙️ Configurações (no canto inferior direito do vídeo).
3. Selecione Legendas/CC.
4. Escolha Tradução automática.
5. Selecione o idioma de sua preferência.

Para ouvir com dublagem automática (experimental):

1. Clique no ícone ⚙️ Configurações.
2. Selecione Faixa de áudio.
3. Escolha o idioma em que deseja ouvir o vídeo.

ℹ️ As traduções e dublagens são geradas automaticamente pelo Google, podem não ser perfeitas e a dublagem automática ainda está em fase de testes, podendo não estar disponível em todos os idiomas.

Antes de implantar um repositório do GitHub no seu site do WordPress.com, primeiro você precisará configurar a conexão entre os dois usando as seguintes etapas:

1. Acesse a página Sites: https://wordpress.com/sites
2. Clique no nome do seu site para abrir a visão geral.
3. Clique na guia Implantações.
4. Clique no botão “Conectar o repositório“. Se houver repositórios listados, significa que você já conectou sua conta do GitHub. Passe para a etapa 11.
5. Clique no botão “Instale o aplicativo do WordPress.com“.
6. Uma nova janela será aberta e você receberá uma solicitação para fazer login em sua conta do GitHub se ainda não tiver feito isso. Você verá esta tela:

7. Clique no botão “Autorizar WordPress.com para desenvolvedores“.
8. Selecione a organização ou conta do GitHub onde seu repositório está localizado.
9. Selecione qual repositório/repositórios você gostaria de conectar:
   • Todos os repositórios: selecionar esta opção concederá ao WordPress.com acesso a todos os repositórios atuais e futuros de propriedade da conta do GitHub selecionada. Isso inclui repositórios públicos que são somente leitura.
   • Apenas repositórios selecionados: selecionar esta opção permitirá escolher quais repositórios o WordPress.com pode acessar na conta do GitHub selecionada. 
10. Após selecionar uma opção, clique no botão Instalar.
11. A nova janela será fechada e você voltará para o WordPress.com. Seus repositórios selecionados devem ser listados junto com a conta do GitHub associada a esse repositório:

12. Clique em Selecionar ao lado do repositório que você deseja conectar.

Nesse momento, você verá WordPress.com for Developers em Aplicativos GitHub autorizados e Aplicativos GitHub instalados.

Após selecionar um repositório, você precisará ajustar as configurações de implantação:

• Ramificação de implantação: tem como padrão a ramificação padrão do repositório (geralmente main), mas pode ser alterada para a ramificação que você quiser usar.
• Diretório de destino: a pasta do servidor onde você deseja implantar os arquivos. Para plugins, será /wp-content/plugins/my-plugin-name. Para temas, será /wp-content/themes/my-theme-name. Para uma implantação parcial do site (ou seja, vários plugins ou temas), você pode usar /wp-content. O conteúdo de um repositório será mesclado com o conteúdo existente do site do WordPress no diretório especificado.
• Implantações automáticas: há duas maneiras de implantar no WordPress.com:
  • Automática: assim que o código for confirmado, ele será implantado no seu site do WordPress.com. Implantações automáticas são recomendadas para sites de teste.
  • Manual: o código será implantado assim que você solicitar uma implantação. Implantações manuais são recomendadas para sites de produção.
• Modo de implantação: há dois tipos de implantações:
  • Simples: esse modo copiará todos os arquivos de uma ramificação do repositório para o site e os implantará sem pós-processamento.
  • Avançado: com esse modo, você pode usar um script de fluxo de trabalho, habilitando etapas de desenvolvimento personalizadas, como instalar dependências do Composer, realizar testes de código pré-implantação e controlar a implantação de arquivos. Ideal para repositórios que precisam do software Composer ou Node. Consulte Implantação avançada abaixo para saber mais.

Após definir todas as configurações, clique no botão Conectar. Seu repositório será adicionado:

Observe que você deve acionar a primeira implantação, automática ou manualmente. Depois disso, você pode conectar outro repositório a qualquer momento clicando no botão “Conectar o repositório“.

Com a Implantação avançada, você pode fornecer um script de fluxo de trabalho para processar arquivos em seu repositório antes da implantação. Isso abre muitas possibilidades, como verificar seu código para garantir que atenda aos padrões de programação da sua equipe, executar testes de unidade, excluir arquivos da implantação, instalar dependências e muito mais. Para começar, confira nossas receitas para fluxo de trabalho.

Para configurar a Implantação avançada:

1. Um formulário será exibido para você configurar a implantação.
2. Clique no nome do repositório para gerenciar a conexão.
3. No lado direito, em “Escolha seu modo de implantação“, escolha Avançado.

4. Se o repositório já incluir um arquivo de fluxo de trabalho, você pode selecioná-lo aqui. O sistema verificará se há erros no arquivo. Se nenhum erro for encontrado, vá para a etapa 7.
5. Você também pode selecionar a opção “Criar novo fluxo de trabalho” para adicionar um arquivo de fluxo de trabalho pré-configurado. Escolher essa opção substituirá o arquivo de fluxo de trabalho wpcom.yml se ele já existir em seu repositório.
6. Clique no botão “Instalar fluxo de trabalho para mim” para executar commit do arquivo de fluxo de trabalho no repositório.
7. Após adicionar e verificar um fluxo de trabalho, clique em Atualizar. Seu repositório agora usará implantação avançada.

Após conectar seu repositório do GitHub a um site, a próxima etapa é implantar seu código. Há dois métodos de implantação disponíveis: Automática e Manual.

Implantações automáticas não são recomendadas para sites de produção ativos, pois todas as alterações de código no repositório são implantadas automaticamente do GitHub para o site ativo. Em vez disso, considere configurar a implantação automática em um site de teste e sincronizá-lo para produção assim que estiver pronto.

Implantações manuais dão a você mais controle sobre quando suas alterações de código são ativadas, pois você precisará acionar manualmente cada implantação. Recomendamos implantações manuais se você não quiser usar um site de teste.

Para acionar manualmente uma implantação:

1. Acesse a página Sites: https://wordpress.com/sites
2. Clique no nome do seu site para abrir a visão geral.
3. Clique na guia Implantações.
4. Clique no menu de reticências (⋮) no repositório que você deseja implantar.
5. Escolha “Acionar implantação manual“. Você verá uma notificação de banner que diz, “Execução de implantação criada”, e o status da implantação mudará para “Na fila”.
6. Aguarde a conclusão da implantação (o status mudará para “Implantado”).

7. Clique novamente no menu de reticências (⋮) e escolha “Ver execuções de implantação“. 
8. O Registro de execução da implantação exibe o Autor e o commit implantado. Se você clicar na entrada de execução da implantação, verá mais informações.

Para gerenciar as conexões existentes do repositório do GitHub:

1. Acesse a página Sites: https://wordpress.com/sites
2. Clique no nome do seu site para abrir a visão geral.
3. Clique na guia Implantações.
4. Você verá a lista de conexões. 

A lista de conexões será exibida se houver pelo menos uma conexão entre um repositório do GitHub e seu site. A lista inclui informações relevantes para cada conexão, como o nome e a ramificação do repositório, o último commit implantado em um site, quando ele ocorreu, onde o código foi colocado, quanto tempo a execução da implantação demorou e seu status.

Há ações adicionais disponíveis após clicar no menu de reticências (⋮):

• Acionar implantação manual: inicia uma execução de implantação no commit mais recente da ramificação configurada.
• Ver execuções de implantação: abre a visualização dos registros de execução de implantação para o repositório conectado.
• Configurar conexão: abre a visualização gerenciar conexão para o repositório.
• Desconectar repositório: remove a conexão entre o repositório e o site.

Os registros de execução da implantação fornecem um registro detalhado passo a passo de cada implantação, seja ela acionada automática ou manualmente. Esses registros ajudam você a rastrear alterações, monitorar o status da implantação e solucionar quaisquer problemas que surjam. Com o acesso aos registros das últimas 10 execuções em até 30 dias, você pode facilmente avaliar o que aconteceu durante cada implantação e garantir que tudo funcione sem problemas.

Para verificar os registros de uma implantação:

1. Acesse a página Sites: https://wordpress.com/sites
2. Clique no nome do seu site para abrir a visão geral.
3. Clique na guia Implantações.
4. Clique no menu de reticências (⋮) ao lado do repositório para o qual você deseja visualizar os registros.
5. Selecione “Ver execuções de implantação“.
6. A visualização de lista de Execuções de implantação mostra os commits implantados no site, o status da implantação, a data e a duração.
7. Clique em qualquer lugar em uma execução para expandir e ver mais informações sobre a implantação.

Os registros incluem todos os comandos executados, desde a busca de código do GitHub até a inclusão no diretório de destino. Você pode expandir as linhas de registro para ver mais informações clicando em “mostrar mais“.

Quando você desconecta um repositório do GitHub do seu site, qualquer alteração futura no repositório não afetará mais seu site. Por padrão, os arquivos implantados permanecem no seu site, mas você tem a opção de removê-los durante o processo de desconexão.

Para remover um repositório:

1. Acesse a página Sites: https://wordpress.com/sites
2. Clique no nome do seu site para abrir a visão geral.
3. Clique na guia Implantações.
4. Clique no menu de reticências (⋮) no repositório.
5. Selecione “Desconectar repositório“.
6. Uma caixa de diálogo será exibida. Clique na opção para remover os arquivos associados do site.
7. Clique em “Desconectar repositório” para fechar a caixa de diálogo e desconectar o repositório.

Observe que o WordPress.com para desenvolvedores ainda aparecerá em Aplicativos GitHub instalados e Aplicativos GitHub autorizados. Isso ocorre porque o WordPress.com ainda tem acesso ao repositório, mas a conexão foi excluída.

Você também pode revogar o acesso do WordPress.com à sua conta do GitHub. Você pode fazer isso a qualquer momento acessando suas Configurações de aplicativos no GitHub. 

Para revogar o acesso de aplicativo autorizado à sua conta do GitHub:

1. Vá para Aplicativos GitHub autorizados.
2. Clique em Revogar ao lado de WordPress.com para desenvolvedores.
3. Clique no botão “Entendido, revogar acesso“.

Mesmo que você revogue o acesso ao aplicativo autorizado, o código ainda poderá ser implantado porque o aplicativo WordPress.com para desenvolvedores permanece instalado nas contas selecionadas.

Para revogar o acesso à instalação do WordPress.com e desativar a capacidade de implantar código em seu site do WordPress.com:

1. Vá para Aplicativos GitHub instalados.
2. Clique em Configurar ao lado de WordPress.com para desenvolvedores.
3. Na área Zona de perigo, clique em Desinstalar e, quando for solicitado, clique em OK .

Remover o WordPress.com da lista de aplicativos autorizados não significa que os repositórios serão excluídos ou deixarão de funcionar. Seus repositórios ainda existirão no GitHub depois que você revogar o acesso do WordPress.com, mas o WordPress.com não poderá mais implantar código.