Ir para o conteúdo

Ambientes

Introdução

A página Ambientes do Management Console permite que administradores da organização Harmony (membros de uma papel com Admin permissão de organização) para configurar ambientes dentro de uma organização para definir e gerenciar o ciclo de vida de um projeto de integração. Você deve configurar pelo menos um ambiente para criar projetos dentro do Harmony.

Membros de uma papel que recebeu Read acesso ao ambiente também pode acessar a página Ambientes. Membros de uma papel que recebeu Write acesso ao ambiente tenham acesso de gravação nesse ambiente.

Cada projeto de integração é implantado em um ambiente Harmony específico. Os ambientes podem ser usados para segregar diferentes estados de um projeto de integração. Por exemplo, uma configuração de ciclo de vida de projeto comum pode ter três ambientes: Desenvolvimento, Teste e Produção.

O acesso que os usuários têm em um ambiente específico depende da combinação das permissões da função da organização e do acesso ao ambiente:

Para acessar um ambiente, todas as funções (mesmo funções com permissão Admin) devem ter acesso a um ambiente para a maioria dos aplicativos. Isso inclui a capacidade de acessar áreas de aplicativos Harmony que exigem a seleção de um ambiente e a capacidade de instalar agentes em um ambiente. As exceções são o EDI e Vinyl aplicativos, que não exigem que quaisquer níveis de acesso ao ambiente sejam concedidos às funções; o acesso a esses aplicativos é regido por permissões da organização sozinho.

Quando estiver pronto para mover um projeto entre ambientes, como de Desenvolvimento para Teste, migre o projeto. Isso pode ser feito no Cloud Studio (consulte Migração de projetos) ou Design Studio (em Arquivo > Migrar Projeto).

Nota

Depois de fazer alterações em um ambiente, pode ser necessário sair e fazer login novamente no Portal Harmony para que essas alterações entrem em vigor em outros aplicativos Harmony.

Acesse a Página Ambientes

Os usuários podem ver ou editar a página Ambientes dependendo da combinação das permissões da função da organização e do acesso ao ambiente:

  • Os membros de uma papel com permissão apenas de Leitura e cuja papel recebeu acesso a um ambiente podem ver informações sobre o ambiente na página Ambientes, mas não podem editá-las.
  • Os membros de uma papel com permissão Admin podem ver e usar todas as ações para todos os ambientes na página Ambientes (mesmo que não tenham recebido acesso de papel ao ambiente).

Para acessar a página Ambientes, faça login no Portal Harmony e, em seguida, use o menu Harmony Portal no canto superior esquerdo para acessar Management Console > Environments:

ambientes de console de gerenciamento

Nota

Certifique-se de estar acessando a organização desejada, que pode ser alterada na barra de navegação superior (veja Alterando a Organização Selecionada em Portal Harmony).

Gerenciar Ambientes

Os administradores da organização Harmony (membros de uma papel com permissão Admin) gerenciam cada ambiente e os grupos de Agente associados a ele. Os membros de uma papel com apenas permissão Leitura e cuja papel recebeu acesso a um ambiente podem ver informações sobre o ambiente, mas não podem adicionar, editar ou remover ambientes.

Ver Ambientes

A seção superior da página Ambientes contém uma tabela que mostra todos os ambientes aos quais você tem acesso na organização selecionada:

Tabela de ambientes

A tabela exibe informações para cada ambiente. Esses campos são configuráveis conforme explicado nas próximas seções:

  • Nome do ambiente: O nome do ambiente.

  • ID do ambiente: O ID do ambiente.

  • Classe de ambiente: A classe do ambiente apenas para fins de relatório.

  • Grupo de Agente: O Grupo de Agentes associado ao ambiente. Para obter mais informações, consulte Agentes > Grupos de Agente.

  • Prefixo de URL: O prefixo de URL do ambiente, a ser usado com APIs Custom, OData e APIs criadas com API Manager.

  • Limite de ocorrências: O número máximo de ocorrências de API por minuto no ambiente, para uso com API Manager.

Outros campos da tabela contêm estatísticas preenchidas automaticamente sobre seu ambiente, incluindo contagens destes itens:

Para classificar a tabela, clique em qualquer um dos cabeçalhos das colunas.

Para filtrar a tabela, use a caixa de pesquisa para inserir critérios de filtro. Passe o mouse sobre ícone para revelar um exemplo da sintaxe de pesquisa.

Para alterar a ordem e a visibilidade das colunas clique Configurações de coluna para abrir o editor de colunas:

Editor de colunas

  • Filtrar Colunas: Insira parte ou todo o nome de uma coluna para reduzir a lista àquelas que correspondem ao texto.

  • Mostrar tudo: Torna todas as colunas visíveis.

  • Mover: Arraste e solte para alterar a posição da coluna em relação a outras.

  • Ocultar: A coluna fica visível. Clique para ocultá-lo.

  • Mostrar: A coluna está oculta. Clique para mostrá-lo.

  • Salvar: Salve quaisquer alterações nas colunas.

  • Cancelar: Feche o editor de colunas sem salvar as alterações.

Dica

As colunas Hit Limit, Hosted-end-points, File Formats e Scripts ficam ocultas quando você abre a página pela primeira vez.

Adicionar Ambientes

Pelo menos um ambiente deve ser definido para cada organização. Você pode estar limitado ao número de ambientes que pode criar com base no seu plano de assinatura Harmony. Se você precisar de ambientes adicionais, entre em contato com seu Gerente de sucesso do cliente.

Para adicionar um ambiente, clique em Adicionar Ambiente para adicionar uma linha à tabela:

Adicionar ambiente

  • Nome do ambiente: O nome do novo ambiente (por exemplo, Desenvolvimento, Teste ou Produção).

    Nota

    Estes caracteres especiais não são permitidos:

    < > # % { } | \ / ^ ~ [ ] ` ; , : ? @ = &

  • Classe de ambiente: A classe do novo ambiente. Use o menu suspenso para selecionar a classe que melhor descreve o ambiente. Este campo é apenas para fins de relatório e não afeta o funcionamento de um ambiente.

  • Grupo de Agente associado: O Grupo de Agentes que você deseja usar para atender o novo ambiente. Use o menu suspenso para selecionar um Grupo de Agentes para o ambiente, escolhendo entre um Grupo de Agentes Privados configurado na página Grupos de Agentes (consulte Agentes > Grupos de Agente) ou um dos Grupos de Agentes em Nuvem (disponível por padrão).

  • Prefixo de URL: O prefixo de URL do ambiente, a ser usado com APIs Custom, OData e Proxy criadas com API Manager. Por padrão, o nome do ambiente é usado. Para obter mais informações, consulte URL do serviço API.

    Independentemente de você usar o ambiente padrão ou inserir um nome personalizado, o prefixo de URL torna-se parte integrante de um API Manager URL de serviço de API. O prefixo URL está limitado a um máximo de 48 caracteres.

    Nota

    Estes caracteres especiais não são permitidos:

    < > # % { } | \ / ^ ~ [ ] ` ; , : ? @ = &

    Além disso, não são permitidos espaços.

  • Limite de ocorrências: O número máximo de ocorrências da API Customizada por minuto no novo ambiente, para uso com API Manager. Se deixado em branco, não há limite para o número de acessos de API no nível do ambiente e o limite de acessos por minuto é padronizado para o limite da organização em todas as APIs em todos os ambientes (conforme declarado em seu contrato de licença Jitterbit). Para obter informações adicionais, consulte Limite de taxa no nível do perfil em Segurança do API Manager.

  • Descrição: Uma descrição do novo ambiente.

Clique Salvar para salvar as configurações ou Cancelar para cancelar.

Editar Ambientes

Para editar um ambiente depois de criado, passe o mouse sobre uma linha e clique no botão Botão Editar na coluna Ação:

Editar ambiente

Os campos editáveis são iguais aos de adicionar um ambiente.

Excluir Ambientes

Para remover um ambiente, passe o mouse sobre uma linha e clique no botão Botão Excluir na coluna Ação. A caixa de diálogo Excluir ambiente é aberta:

Excluir caixa de diálogo

Para continuar a ação, insira a palavra DELETE no campo de texto e clique no botão Delete.

Para abandonar a ação, clique no botão Cancelar.

Gerenciar o Acesso de Função aos Ambientes

Antes de conceder acesso de papel a um ambiente, você deve definir as funções que podem ter acesso. A associação individual para essas funções é definida no nível da organização (consulte Gerenciamento de permissões, funções e membros em Organizações página). Depois que as funções forem definidas, você poderá conceder às funções diferentes níveis de acesso a um ambiente.

Os níveis de acesso no nível do ambiente são usados em combinação com as permissões da organização para aumentar a capacidade dos administradores de controlar o que os membros de uma papel específica podem fazer em um ambiente específico. Por exemplo, os usuários em uma papel de desenvolvedor de nível básico podem ter acesso Read, Execute e Write em um ambiente de desenvolvimento, mas apenas acesso Read em um ambiente de teste e nenhum acesso em um ambiente de produção.

Níveis de Acesso

Ao conceder acesso de papel a um ambiente, você pode selecionar um dos quatro níveis de acesso ao ambiente em cascata. Ver Logs é o nível de acesso mais baixo, seguido por Ler, Executar e então Escrever como o nível de acesso mais alto. À medida que você seleciona um nível de acesso mais alto, todos os níveis de acesso mais baixos são selecionados automaticamente e não podem ser apagados.

Os níveis de acesso são independentes e diferentes das permissões da organização atribuído a uma papel das Organizações página. Por exemplo:

  • Um membro de uma papel com permissão Read no nível da organização ainda poderá fazer edições em um ambiente se o acesso Write for concedido à papel no nível do ambiente.
  • Um membro de uma papel com permissão Admin no nível da organização, mas que tenha apenas acesso Read no nível do ambiente, não poderá implantar, executar ou editar projetos nesse ambiente.
  • Um membro de uma papel com permissão Admin no nível da organização, mas que não recebeu acesso ao ambiente, não consegue acessar o ambiente.

Os quatro níveis de acesso ao ambiente estão descritos na tabela abaixo.

Nota

O acesso conforme descrito abaixo será fornecido somente se a papel da organização atribuída tiver permissão de Leitura ou Admin. Se a papel da organização tiver apenas permissão Agent-Install, ApiConsumer ou App Developer, os membros dessas funções não terão acesso às páginas ou ações descritas aqui, apesar dos níveis de acesso ao ambiente estarem selecionados.

Dica

Os níveis de acesso ao ambiente não concedem acesso adicional ao EDI e Vinyl formulários; o acesso a esses aplicativos é regido por permissões da organização sozinho.

Nível de acesso ao ambiente Nível de acesso Acesso ao ambiente quando concedido a uma função
com permissão Read ou Admin
Notas
Ver registros Mais baixo Acesso a: O acesso à página Atividades é limitado à visualização da tabela de operações e não inclui a possibilidade de acessar mensagens de log (consulte Mensagens de log em Atividades). Para visualizar mensagens de log, é necessário acesso Execute ou superior. Visualizar logs é selecionado automaticamente se qualquer outro nível de acesso (Leitura, Executar ou Gravar) for selecionado.
Leia Baixo Acesso a: O acesso às páginas e aplicativos listados acima é limitado à visualização de páginas ou à abertura de configurações de componentes. O acesso de leitura não inclui a implantação de projetos.

Leitura é selecionado automaticamente se o acesso Executar ou Gravar for selecionado.

Quando esse nível de acesso é selecionado, o nível de acesso Exibir registros é automaticamente selecionado e não pode ser apagado.

Esse nível de acesso é comumente usado para limitar o acesso a projetos implantados em ambientes críticos, como um ambiente de produção.

Quando concedido a uma papel com permissão ApiConsumer, Read access fornece acesso ao API Manager Portal através de um link direto.

Executar Alto Acesso para executar estas ações:

Execute é selecionado automaticamente se o acesso Write for selecionado.

Quando esse nível de acesso é selecionado, os níveis de acesso View Logs e Read são automaticamente selecionados e não podem ser apagados.

Esse nível de acesso é comumente usado para limitar o acesso em ambientes de teste e geralmente é concedido a usuários que precisam oferecer suporte a uma integração, pois podem precisar executar operações e visualizar logs de operação.

Em organizações cuja assinatura do Harmony expirou, esse nível de acesso é efetivamente igual ao nível de acesso Leitura.

Escrever Mais alto Acesso e capacidade de fazer edições e executar ações como implantação (quando aplicável) em:

Quando esse nível de acesso é selecionado, os níveis de acesso Ver Logs, Ler e Executar são selecionados automaticamente e não podem ser apagados.

Quando concedido a uma papel com Agente- Permissão de instalação, acesso de Escrita fornece a capacidade de instalar agentes.

Em organizações cuja assinatura do Harmony expirou, esse nível de acesso é efetivamente o mesmo que o nível de acesso de Leitura.

Portal do API Manager

Esses critérios adicionais devem ser atendidos antes que a página Portal do API Manager esteja acessível:

Além do acesso pelo aplicativo API Manager, a página do Portal pode ser acessada por:

  • Um link direto para consumidores de API que têm permissão ApiConsumer em uma organização e um mínimo de acesso Read em um ambiente. Para obter o link direto, copie a URL da página Portal do API Manager ou o link para Visualizar documentação da API na página Portal Manager.

  • Um convite de um administrador da organização Harmony através do Management Console Gerenciamento de usuários página.

Visualizar e Editar o Acesso de Função a um Ambiente

Para visualizar ou editar o acesso à papel de um ambiente, selecione uma linha na tabela. Na seção inferior da página Ambientes, o painel Acesso à função exibe todas as funções que podem receber acesso ao ambiente selecionado:

Acesso à função

Nota

Se uma papel que já recebeu acesso a um ambiente for desativada ou tiver sido excluída da organização (da seção Organizações), a papel não será exibida.

Para selecionar ou limpar um nível de acesso, ative ou desative a alternância de nível de acesso. Uma caixa de diálogo de confirmação é exibida.

Para limpar todos os níveis de acesso de uma papel, clique no nível de acesso Exibir registros de uma função para desativar a seleção.

Os níveis de acesso disponíveis em um ambiente são descritos detalhadamente acima em Níveis de acesso.

Conceder Acesso de Função a um Ambiente

Selecione um ambiente para revelar o painel Acesso à função na parte inferior da tela:

Acesso à função

  • Pesquisar: Pesquise funções que correspondam ao texto. As pesquisas não diferenciam maiúsculas de minúsculas. Para mostrar todas as funções, exclua o texto.

  • Atualizar: Atualize as funções.

  • Anterior: Selecione o ambiente anterior na tabela.

  • Próximo: Selecione o próximo ambiente na tabela.

  • Tela inteira: Aumente o tamanho do painel Acesso à função para preencher a janela do navegador.

  • Sair da tela inteira: Retorne o tamanho do painel Acesso à função ao normal.

  • Fechar: Feche o painel Acesso à função.