Variáveis de ambiente no Cloud Manager environment-variables
As variáveis de ambiente padrão podem ser configuradas e gerenciadas pelo Cloud Manager. Eles são fornecidos para o ambiente de tempo de execução e podem ser usados nas configurações do OSGi.
As variáveis de ambiente podem ser valores específicos ou segredos do ambiente, com base no que está sendo alterado.
Sobre variáveis de ambiente overview
As variáveis de ambiente oferecem vários benefícios aos usuários do AEM as a Cloud Service, como os seguintes:
- Elas permitem que o comportamento do código e do aplicativo varie com base no contexto e no ambiente. Por exemplo, elas podem ser usadas para permitir configurações diferentes no ambiente de desenvolvimento em comparação aos ambientes de produção ou de preparo para evitar erros dispendiosos.
- Elas somente precisam ser configuradas uma vez, e podem ser atualizadas e excluídas quando necessário.
- Seus valores podem ser atualizados a qualquer momento e têm efeito imediatamente, sem a necessidade de alterações ou implantações de código.
- Elas podem separar o código da configuração e eliminar a necessidade de incluir informações confidenciais no controle de versão.
- Elas melhoram a segurança do aplicativo do AEM as a Cloud Service, pois residem fora do código.
Casos de uso típicos para as variáveis de ambiente incluem:
- Conectar o aplicativo do AEM a diferentes endpoints externos
- Usar uma referência ao armazenar senhas em vez de armazená-la diretamente na base do código
- Quando existem vários ambientes de desenvolvimento em um programa e algumas configurações diferem de um ambiente para outro
Adicionar uma variável de ambiente add-variables
Se você quiser adicionar várias variáveis, o Adobe recomenda que você adicione a primeira variável e, em seguida, use o
Para adicionar, atualizar ou excluir variáveis de ambiente, você deve ser membro da função de Gerente de Implantação.
Para adicionar uma variável de ambiente:
-
Faça logon no Cloud Manager, em my.cloudmanager.adobe.com, e selecione a organização apropriada.
-
No console Meus Programas, selecione aquele que deseja gerenciar.
-
No menu lateral, clique em Ambientes.
-
Na página Ambientes, selecione uma linha na tabela que tenha o ambiente para o qual você deseja adicionar uma variável de ambiente.
-
Na página de detalhes do ambiente, clique na guia Configuração.
-
Clique em
Se você estiver adicionando uma variável de ambiente pela primeira vez, clique em Adicionar configuração no centro da página.
-
Na caixa de diálogo Configuração do Ambiente, insira os detalhes na primeira linha da tabela.
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 Texto Descrição Nome Um nome exclusivo da variável de configuração. Ela identifica a variável específica usada no ambiente. Ele deve seguir as seguintes convenções de nomenclatura:
- As variáveis só podem conter caracteres alfanuméricos e sublinhado (
_). - Há um limite de 200 variáveis por ambiente.
- Cada nome deve ter 100 caracteres ou menos.
Valor O valor que a variável contém. Etapa aplicada Selecione a qual serviço a variável se aplica. Selecione Todos para aplicar a variável a todos os serviços.
- Tudo
- Autor
- Publish
- Visualização
Tipo Selecione se a variável for normal ou um segredo. 
- As variáveis só podem conter caracteres alfanuméricos e sublinhado (
-
Clique no ícone
Adicione mais variáveis, conforme necessário.
-
Clique em Salvar.
Um ponteiro com o status Atualizando é mostrado no canto superior direito da tabela. Um ponteiro também é exibido à esquerda de qualquer variável adicionada recentemente. Esses status indicam que o ambiente está sendo atualizado com a configuração. Após a conclusão, a nova variável de ambiente estará visível na tabela.
Atualizar uma variável de ambiente update-variables
Depois de criar as variáveis de ambiente, você pode atualizá-las usando
Se você deseja atualizar várias variáveis, a Adobe recomenda usar a caixa de diálogo Configuração do ambiente para atualizar todas as variáveis necessárias de uma só vez antes de clicar em Salvar. Dessa forma, você pode adicioná-las com uma atualização ao ambiente.
Para atualizar uma variável de ambiente:
-
Faça logon no Cloud Manager, em my.cloudmanager.adobe.com, e selecione a organização apropriada.
-
No console Meus Programas, selecione aquele que deseja gerenciar.
-
No menu lateral, clique em Ambientes.
-
Na página Ambientes, selecione uma linha na tabela que tenha o ambiente para o qual você deseja atualizar uma variável.
-
Na página de detalhes do ambiente, clique na guia Configuração.
-
Clique em
-
Na caixa de diálogo Configuração do Ambiente, clique em
-
No menu suspenso, clique em Editar.
-
Atualize o valor da variável de ambiente conforme necessário.
Ao editar um segredo, o valor só pode ser atualizado, não visualizado.
-
Siga uma das seguintes opções:
- Clique em
- Clique no
- Clique em
-
Clique em Salvar.
Um ponteiro com o status Atualizando é mostrado no canto superior direito da tabela. Um ponteiro também é exibido à esquerda de qualquer variável atualizada. Esses status indicam que o ambiente está sendo atualizado com a configuração. Após a conclusão, a variável de ambiente atualizada fica visível na tabela.
Excluir uma variável de ambiente delete-env-variable
- Faça logon no Cloud Manager, em my.cloudmanager.adobe.com, e selecione a organização apropriada.
- No console Meus Programas, selecione aquele que deseja gerenciar.
- No menu lateral, clique em Ambientes.
- Na página Ambientes, selecione uma linha na tabela que tenha o ambiente para o qual você deseja atualizar uma variável.
- Na página de detalhes do ambiente, clique na guia Configuração.
- Clique em
- Na caixa de diálogo Configuração do Ambiente, clique em
- No menu suspenso, clique em Excluir para remover a variável imediatamente.
- Clique em Salvar.
Uso de variáveis de ambiente using
As variáveis de ambiente podem tornar suas configurações pom.xml mais seguras e flexíveis. Por exemplo, senhas não precisam ser codificadas e sua configuração pode ser ajustada com base nos valores das variáveis de ambiente.
Você pode acessar segredos e variáveis de ambiente por meio do XML, como segue:
${env.VARIABLE_NAME}
Consulte Configurando o Projeto para obter um exemplo de como usar os dois tipos de variáveis em um arquivo pom.xml.
Consulte também a documentação oficial do Maven para obter mais detalhes.
Disponibilidade de variáveis de ambiente availability
As variáveis de ambiente podem ser usadas em vários lugares da seguinte maneira:
Somente variáveis de ambiente regulares podem ser usadas com a Dispatcher.
- Não é possível usar segredos.
- As variáveis de ambiente não podem ser usadas em diretivas
IfDefine. - Valide o uso das variáveis de ambiente com o Dispatcher localmente antes da implantação.