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

Esta seção aborda várias operações administrativas, por exemplo, criação, gerenciamento e remoção de organizações, ambientes e hosts virtuais do 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 local do Edge Private Cloud. Para verificar o status do usuário, da organização e da implantação no servidor de gerenciamento, execute 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 precisa mostrar o status HTTP 200 para todas as chamadas. Se eles 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 mostrados abaixo usam um arquivo de configuração como entrada. Por exemplo, transmita 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 um arquivo de configuração completo e informações sobre as propriedades que podem ser definidas nele, 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, especifique as seguintes informações:

  • O nome do host virtual usado 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 são incrementadas 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 "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 do 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.

Se você tiver uma entrada DNS para o host virtual

Por exemplo, se você criou um host virtual com um alias de host myapis.apigee.net na porta 9001, a execução de uma solicitação curl para uma API por esse host virtual pode usar o seguinte formato:

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

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 formulário 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 e a porta do host virtual.

Como alternativa, defina o alias de host como um valor, como temp.hostalias.com. Em seguida, transmita 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 arquivo /etc/hosts. Por exemplo, adicione esta linha a /etc/hosts:

192.168.1.31   temp.hostalias.com

Em seguida, você pode fazer uma solicitação como se tivesse uma entrada DNS:

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