DocumentaçãoCommerceGuia do Commerce na infraestrutura em nuvem

Gerenciar ramificações com o Cloud Console

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Desenvolvedor

Você pode gerenciar seus ambientes usando a CLI do Cloud Console ou do magento-cloud. Os arquivos do projeto são armazenados em um repositório Git. Você pode usar comandos do Git para gerenciar seu código, mas a CLI do magento-cloud foi projetada para interagir com recursos da plataforma, enquanto os comandos do Git não. Consulte Comandos do Git no tópico da CLI da nuvem.

Este tópico discute como usar o Cloud Console para:

  • Adicionar ou excluir um ambiente
  • Sincronizar (git pull) a partir do ambiente pai
  • Mesclar (git push) com o ambiente pai
TIP
Não é possível criar ramificações de ambientes de preparo e produção profissionais. Você pode ramificar da ramificação master.

Criar um ambiente

A estratégia de ramificação usa um fluxo de trabalho Git comum, no qual você desenvolve o código e adiciona extensões em uma ramificação de desenvolvimento. Consulte as visões gerais de arquitetura do Starter e do Pro.

  • Para Iniciante, crie uma ramificação staging da ramificação master e, em seguida, ramifique de staging para desenvolvimento.
  • Para Pro, crie uma ramificação de desenvolvimento do ambiente Integration.

Sua conta oferece suporte a um número limitado de ramificações de desenvolvimento ativas {width="32"} (active) and an unlimited number of inactive branch {width="32"} (inativas). Gerencie ramificações ativas e inativas adicionando ou excluindo uma ramificação usando somente o Cloud Console ou a CLI da nuvem. Antes de excluir uma ramificação, desative-a, que permanece na lista Ambientes como inativa. Você pode reativar a ramificação mais tarde ou excluir a ramificação nas configurações do ambiente ou usando a CLI da nuvem.

Se você precisar de ambientes ativos adicionais para desenvolvimento, envie um Tíquete de suporte.

Para adicionar uma ramificação:

  1. Faça logon no Cloud Console.

  2. Selecione um projeto na lista Todos os projetos.

  3. Selecione um ambiente.

    note tip
    TIP
    Sua nova ramificação será clonada deste ambiente. Escolha um ambiente pai semelhante ao ambiente que você está prestes a criar.

  4. Clique em Branch.

    Criar uma ramificação {width="150"}

  5. No formulário Ramificação de …, digite um nome de ramificação.

    O ambiente name é diferente do ambiente ID somente se você usar espaços ou letras maiúsculas no nome do ambiente. Uma ID de ambiente consiste em todas as letras minúsculas, números e símbolos permitidos. Letras maiúsculas em um nome de ambiente são convertidas em minúsculas na ID; espaços em um nome de ambiente são convertidos em traços.

    Um nome de ambiente não pode incluir caracteres reservados para o shell do Linux ou para expressões regulares. Os caracteres proibidos incluem chaves ({ }), parênteses, asterisco (*), colchetes (>), E comercial (&), porcentagem (%) e outros caracteres.

  6. Selecione um Environment type.

  7. Clique em Create Branch.

  8. Espere enquanto o ambiente é implantado.

    Durante a implantação, o status do ambiente é Em andamento. Após uma implantação bem-sucedida, o status muda para uma marca de seleção verde para sucesso.

Criar ramificação inativa

Não é possível criar uma ramificação inativa no console ou na CLI do Adobe Commerce Cloud. Se quiser criar uma ramificação inativa, crie-a no repositório Git e envie por push usando a opção environment.Parent no comando.

git push -o "environment.Parent=<parent branch>" <origin> <branch>

Excluir um ambiente

Antes de excluir um ambiente, você deve desativá-lo. Depois que um ambiente estiver inativo, você poderá excluí-lo.

Para desativar um ambiente:

  1. Faça logon no Cloud Console.

  2. Selecione um projeto na lista Todos os projetos.

  3. Selecione o ambiente na lista da barra de navegação Ambiente.

  4. Clique no ícone de configuração no lado direito da barra de navegação superior, que abre as configurações do ambiente.

  5. Na guia General, role para baixo até a seção​ Deactivate environment, clique em Deactivate environment and delete data e siga as instruções.

Sincronizar um ambiente

A sincronização de um ambiente (ou ramificação) é igual a git pull origin <parent>. Você pode sincronizar o código atualizado de um ambiente primário. Você pode usar esse recurso por meio do Cloud Console para todos os ambientes Starter e Pro.

Para o plano Pro, você pode sincronizar do ambiente de preparo e produção para a ramificação master. Essa sincronização extrai e envia apenas código, não dados. Para sincronizar dados, descarte os dados do banco de dados e envie-os para o banco de dados de outro ambiente. Consulte Migrar e implantar arquivos e dados estáticos.

Para sincronizar um ambiente:

  1. Faça logon no Cloud Console.

  2. Selecione um projeto na lista Todos os projetos.

  3. Na lista de ambientes, clique no nome da ramificação a ser sincronizada.

  4. Clique em (sincronizar).

    Sincronizar um ambiente {width="150"}

  5. Selecione os itens a serem sincronizados.

    • Substituir os dados — (dados e arquivos) sincroniza alterações no banco de dados e arquivos de conteúdo da ramificação pai.
    • Mesclar — (código) sincroniza o código atualizado da ramificação principal.

    Isso também cria um comando CLI para você copiar e usar.

  6. Clique em Sincronizar.

Mesclar com ambiente pai

Mesclar um ambiente (ou ramificação) é o mesmo que git push origin. Você mescla para enviar o código atualizado de um ambiente para o ambiente pai. Você pode mesclar este código a master. Você pode implantar em Preparo e Produção usando o comando merge.

Para mesclar com o ambiente pai:

  1. Faça logon no Cloud Console.

  2. Selecione um projeto na lista Todos os projetos.

  3. Na lista de ambientes, clique no nome da ramificação a ser mesclada.

  4. Clique em (mesclar).

    Mesclar um ambiente {width="150"}

  5. Clique em Mesclar e confirme a ação.

Exibir logs

Por meio do Cloud Console, você pode revisar vários logs de ambientes, incluindo histórico de compilação, implantação e implantação.

Para Início, você pode revisar os logs de compilação e implantação e o histórico de implantação. Esses ambientes incluem a ramificação master (Produção) e todas as ramificações criadas a partir dela.

Para Pro, você pode examinar os seguintes logs em cada ambiente:

  • Integração — criação, implantação e histórico de implantação
  • Preparação — crie logs e histórico de implantação. Use SSH para fazer logon no servidor e exibir logs de implantação.
  • Produção — crie logs e histórico de implantação. Use SSH para fazer logon no servidor e exibir logs de implantação.

Para exibir logs emCloud Console:

  1. Faça logon no Cloud Console.

  2. Selecione um projeto na lista Todos os projetos.

  3. Selecione um ambiente.

    A exibição de ambiente fornece uma Lista de atividades que mostra eventos recentes, com uma tentativa de entrada por ação incluindo sincronizações, mesclagens, ramificações, backups e muito mais. Clique em Tudo para obter o histórico completo de implantação.

  4. Para exibir o log de compilação, selecione o link Sucesso ou Falha por registro de implantação na conta.

TIP
Clique no ícone Filtrar por para obter uma lista suspensa e selecione o tipo de mensagens a serem exibidas.

Obter código de um repositório Git privado

Seu projeto de infraestrutura do Adobe Commerce na nuvem pode incluir código de um repositório Git privado. Por exemplo, você pode ter código para um módulo personalizado ou tema em um repositório privado. Para fazer isso, você deve adicionar a chave SSH pública do seu projeto ao seu repositório Git privado e atualizar o arquivo do projeto composer.json.

Para adicionar uma chave de implantação ao seu repositório GitHub privado, você deve ser o administrador desse repositório. O GitHub permite usar uma chave de implantação somente para um repositório.

Se preferir que o projeto acesse vários repositórios, é possível anexar uma chave SSH a uma conta de usuário automatizada. Como esta conta não é usada por um humano, ela é chamada de usuário da máquina. Adicione a conta da máquina como colaborador ou adicione o usuário da máquina a uma equipe com acesso aos repositórios.

INFO
A Adobe recomenda adicionar e mesclar esse código aos repositórios Git do projeto. Se você não configurar a conexão, poderá ter problemas de build.

Para encontrar sua chave pública SSH:

  1. Faça logon no Cloud Console.

  2. Selecione um projeto na lista Todos os projetos.

  3. Clique no ícone de configuração no lado direito da barra de navegação superior.

  4. Em Configurações do projeto, clique em Deploy Key.

  5. Copie a chave de implantação na área de transferência para uso em um dos seguintes métodos baseados em Git:

GitHub

Insira sua chave de implantação do GitHub

No GitHub, as chaves de implantação são somente leitura por padrão.

Para inserir sua chave pública de projeto como uma chave de implantação do GitHub:

  1. Faça logon no repositório GitHub como administrador.

  2. Clique na guia repositório Settings.

    note note
    NOTE
    Caso não veja essa opção, você não está conectado como administrador de repositório e não pode concluir essa tarefa. Peça ao administrador do repositório GitHub para fazer isso.

  3. Na guia Configurações da navegação à esquerda, clique em Deploy Keys.

  4. Clique em Add deploy key.

  5. Siga as instruções.

Em composer.json, use o formato <user>@<host>:<.git</code>, ou ssh://<user>@<host>:<port>/<path>.git se estiver usando uma porta não padrão.

Bitbucket

Insira sua chave de implantação do Bitbucket

Para inserir sua chave pública do projeto como uma chave de implantação de Bitbucket:

  1. Faça logon no repositório Bitbucket como administrador.

  2. Na navegação à esquerda, clique em Settings.

  3. Clique em Geral > Deployment Keys.

  4. Clique em Add Key.

  5. Siga as instruções.

GitLab

Insira sua chave de implantação do GitLab

Para adicionar a chave SSH pública para o seu projeto como uma chave de implantação do GitLab:

  1. Faça logon no repositório do GitLab como proprietário.

  2. Verifique se a opção Pipelines está habilitada para o seu projeto:

    1. Nas configurações do projeto, expanda a seção Visibility, project, features, permissions.
    2. Se necessário, clique em Pipelines para habilitar a opção.

  3. Adicione sua chave SSH pública às configurações de CI/CD.

    1. Na navegação à esquerda, clique em Configurações > CI / CD.
    2. Clique em Implantar Chaves Expandir para configurar a chave.
    3. No formulário Implantar Chave, adicione um nome de chave de implantação ao campo Title e cole sua chave SSH pública no campo Key.
    4. Clique em Add Key para salvar a configuração.

Ambientes e ramificações seguros

Você pode acessar seus projetos e ambientes de qualquer local usando um navegador da Web com o Cloud Console. Você pode ter o conjunto de segurança para seu ambiente de produção, lojas e sites. Esta seção ajuda a proteger os ambientes de Integração e Preparo exclusivamente para seus desenvolvedores, DBAs e muito mais.

WARNING
NÃO use os métodos a seguir para proteger ambientes de Preparo e Produção Profissionais. Isso interrompe o armazenamento em cache do Fastly. Use o recurso Bloqueio disponível no Fastly CDN para Adobe Commerce.

Para proteger ambientes:

  1. Faça logon no Cloud Console.

  2. Selecione um projeto na lista Todos os projetos.

  3. Selecione um ambiente e clique no ícone de configuração na barra de navegação.

  4. Na guia de configurações do ambiente Geral, clique em LIGADO para HTTP access control enabled habilitar o acesso seguro. Você pode escolher entre credenciais ou endereços IP para filtrar o acesso.

  5. Para filtrar por credenciais, clique em Add Login, digite um nome de usuário e senha e clique em Add Login para adicionar.

  6. Para filtrar por endereço IP, insira os endereços IP em uma lista com deny ou allow. Por exemplo:

    code language-text 
    123.456.789.111/29 allow
123.456.789.112/29 allow
234.123.567.111/29 allow
0.0.0.0/0 deny

  7. Clique em Save. Isso reimplanta o ambiente para atualizar a segurança e as configurações. A Adobe recomenda testar o ambiente após concluir as configurações de segurança.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26