Gerenciar ramificações com o Cloud Console

Você pode gerenciar seus ambientes usando o Cloud Console ou o magento-cloud CLI. 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 variável magento-cloud A CLI foi projetada para interagir com os recursos da plataforma, enquanto os comandos Git não. Consulte Comandos do Git no tópico da CLI da nuvem.

Este tópico discute como usar a variável Cloud Console para:

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

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 Início e Pro visões gerais de arquitetura.

  • Para começar, crie um staging ramificação da master ramificação e ramificação de staging para desenvolvimento.
  • Para Pro, crie uma ramificação de desenvolvimento no Integration ambiente.

Sua conta aceita um número limitado de ramificação ativa {width="32"} (active) and an unlimited number of inactive branch {width="32"} ramificações de desenvolvimento (inativas). Gerenciar 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, você a desativa, o que permanece na Ambientes listar como inativo. É possível reativar a ramificação mais tarde ou excluir a ramificação nas configurações do ambiente ou usando a CLI da nuvem.

Se 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 lista.

  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 Ramificando de … insira 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 é possível inclui caracteres reservados para o shell do Linux ou para expressões regulares. Os caracteres proibidos incluem chaves ({ }), parênteses, asterisco (*), colchetes angulares (>), 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 success.

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 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 lista.

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

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

  5. No General, role até a guia​ Deactivate environment e clique em Deactivate environment and delete data e siga as instruções.

Sincronizar um ambiente

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

Para o plano Pro, você pode sincronizar do armazenamento temporário e da produção para o master filial. 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 lista.

  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 esse código com master. Você pode implantar em Preparo e Produção usando o merge comando.

Para mesclar com o ambiente pai:

  1. Faça logon no Cloud Console.

  2. Selecione um projeto na lista Todos os projetos lista.

  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 da Cloud Console, você pode revisar vários logs para ambientes, incluindo criação, implantação e histórico de implantação.

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

Para Pro, você pode revisar 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 os logs noCloud Console:

  1. Faça logon no Cloud Console.

  2. Selecione um projeto na lista Todos os projetos lista.

  3. Selecione um ambiente.

    A visualização de ambiente fornece uma Lista de atividades que mostra recente eventos, uma entrada por ação tentada incluindo sincronizações, mesclagens, ramificações, backups e muito mais. Clique em Todos para obter o histórico completo da 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 em Filtrar por para obter uma lista suspensa e selecionar 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 seu projeto composer.json arquivo.

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 essa 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 lista.

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

  4. Entrada 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 no repositório Settings guia.

    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. No Configurações na navegação à esquerda, clique em Deploy Keys.

  4. Clique em Add deploy key.

  5. Siga as instruções.

Entrada composer.json, use o <user>@<host>:<.git</code> formato, 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 a 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 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 Pipelines está ativada para o projeto:

    1. Nas configurações do projeto, expanda a Visibility, project, features, permissions seção.
    2. Se necessário, clique em Pipelines para ativar 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 Implantar chave formulário, adicione um nome de chave de implantação à Title e cole sua chave SSH pública no campo Key campo.
    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 por meio de um navegador da Web, usando 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 Pro Staging e Production. Isso interrompe o armazenamento em cache do Fastly. Use o Bloqueio recurso 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 lista.

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

  4. Nas configurações do ambiente Geral clique em LIGADO para HTTP access control enabled para ativar 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