Manutenção da organização e do ambiente

Esta seção abrange várias operações administrativas, por exemplo, criação, gerenciamento e remoção de organizações, ambientes e hosts virtuais da Apigee em uma instalação do Apigee Edge para nuvem privada.

Para uma introdução a organizações, ambientes e hosts virtuais, consulte Sobre planetas, regiões, pods, organizações, ambientes e hosts virtuais.

Verificação do status de usuários, organização e ambiente

O servidor de gerenciamento desempenha um papel vital na manutenção de todos os outros componentes em uma instalação local da nuvem privada de borda. É possível verificar o status do usuário, da organização e da implantação no servidor de gerenciamento emitindo os seguintes comandos curl:

curl -u adminEmail:admin_passwd http://localhost:8080/v1/users
curl -u adminEmail:admin_passwd http://localhost:8080/v1/organizations
curl -u adminEmail;:admin_passwd http://localhost:8080/v1/organizations/orgname/deployments

O sistema vai mostrar o status HTTP 200 para todas as chamadas. Se elas falharem, faça o seguinte:

  1. Verifique se há erros nos registros do servidor de gerenciamento em /opt/apigee/var/log/apigee/management-server.
  2. Faça uma chamada no Servidor de gerenciamento para verificar se ele está funcionando corretamente.
  3. Remova o servidor do ELB e reinicie o servidor de gerenciamento: 
    /opt/apigee/bin/apigee-service management-server restart

Sobre o uso de arquivos de configuração

Os comandos abaixo usam um arquivo de configuração como entrada. Por exemplo, você transmite um arquivo de configuração ao comando setup-org para definir todas as propriedades da organização, incluindo o ambiente e o host virtual.

Para um arquivo de configuração completo e informações sobre as propriedades que podem ser definidas no arquivo de configuração, consulte Integrar uma organização.

Sobre a configuração de um host virtual

Um host virtual na borda define os domínios e as portas do roteador de borda em que um proxy de API é exposto e, por extensão, o URL que os apps usam para acessar um proxy de API. Um host virtual também define se o proxy de API é acessado usando o protocolo HTTP ou o protocolo HTTPS criptografado.

Use os scripts e chamadas de API mostrados abaixo para criar um host virtual. Ao criar o host virtual, especifique as seguintes informações:

  • O nome do host virtual que você usa para referenciá-lo nos proxies da API.
  • A porta do roteador do host virtual. Normalmente, essas portas começam em 9001 e aumentam em um para cada novo host virtual.
  • O alias de host do host virtual. Normalmente, o nome DNS do host virtual.

    O roteador de borda compara o cabeçalho "Host" da solicitação recebida com a lista de aliases de host como parte para determinar o proxy de API que processa a solicitação. Ao fazer uma solicitação por meio de um host virtual, especifique um nome de domínio que corresponda ao alias de host de um host virtual ou especifique o endereço IP do roteador e o cabeçalho Host que contém o alias do host.

Por exemplo, se você criou um host virtual com um alias de host myapis.apigee.net na porta 9001 e, em seguida, execute uma solicitação curl para uma API por esse host virtual poderá usar uma das seguintes formas:

  • Se houver uma entrada de DNS para myapis.apigee.net: 
    curl http://myapis.apigee.net:9001/proxy-base-path/resource-path
  • Se você não tiver uma entrada DNS para myapis.apigee.net: 
    curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'

    Na segunda forma, você especifica o endereço IP do roteador e transmite o alias do host no cabeçalho "Host".

Opções quando você não tem uma entrada DNS para o host virtual

Uma opção quando você não tem uma entrada DNS é definir o alias do host como o endereço IP do roteador e a porta do host virtual, como routerIP:port. Exemplo:

192.168.1.31:9001

Em seguida, crie um comando curl no formato abaixo:

curl http://routerIP:9001/proxy-base-path/resource-path

Essa opção é preferível porque funciona bem com a interface do Edge.

Se você tiver vários roteadores, adicione um alias de host para cada um deles, especificando o endereço IP de cada um deles e a porta do host virtual.

Como alternativa, você pode definir o alias do host como um valor, como temp.hostalias.com. Em seguida, é necessário transmitir o cabeçalho Host em todas as solicitações:

curl -v http://routerIP:9001/proxy-base-path/resource-path -H 'Host: temp.hostalias.com'

Ou adicione o alias de host ao seu arquivo /etc/hosts. Por exemplo, adicione esta linha a /etc/hosts:

192.168.1.31   temp.hostalias.com

Em seguida, faça uma solicitação como se tivesse uma entrada DNS:

curl -v http://myapis.apigee.net:9001/proxy-base-path/resource-path