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

Nesta seção, abordamos várias operações administrativas, como 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.

Como verificar o status de usuários, organização e ambiente

O servidor de gerenciamento desempenha um papel vital na união de todos os outros componentes em uma instalação no local do Edge nuvem privada. Verifique 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 mostra o status HTTP 200 para todas as chamadas. Se isso não funcionar, 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 para o servidor de gerenciamento para verificar se ele está funcionando corretamente.
  3. Remova o servidor do ELB e reinicie o Management Server: 
    /opt/apigee/bin/apigee-service management-server restart

Sobre o uso de arquivos de configuração

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

Para ver 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 no Edge define os domínios e as portas do roteador do Edge 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 as chamadas de API mostrados abaixo para criar um host virtual. Ao criar o host virtual, você precisa especificar as seguintes informações:

  • O nome do host virtual que você usa para fazer referência a ele nos proxies de API.
  • A porta no roteador para o 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 do Edge compara o cabeçalho do host da solicitação recebida com a lista de aliases de host como parte da determinação do proxy de API que processa a solicitação. Ao fazer uma solicitação por 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 do host que contém o alias de host.

Por exemplo, se você criou um host virtual com um alias de host de myapis.apigee.net na porta 9001, execute uma solicitação curl para uma API por meio desse host virtual que pode usar uma das seguintes formas:

  • Se você tiver uma entrada 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, 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, use 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, especificando o endereço IP de cada roteador e a porta do host virtual.

Como alternativa, é possível definir o alias do host como um valor, como temp.hostalias.com. Em seguida, é necessário transmitir o cabeçalho Host em cada solicitação:

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

Ou adicione o alias de host ao 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