Edge para nuvem privada v. 4.17.09
Esta seção aborda várias operações administrativas, como 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 às organizações, aos ambientes e aos hosts virtuais, consulte Sobre planetas, regiões, pods, organizações, ambientes e hosts virtuais.
Como verificar o status de usuários, organizações e ambientes
O Management Server desempenha um papel vital na união de todos os outros componentes em uma instalação local da Edge Private Cloud. É possível verificar o status do usuário, da organização e da implantação no servidor de gerenciamento emitindo os seguintes comandos do 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 deve exibir o status HTTP 200 para todas as chamadas. Se eles falharem, faça o seguinte:
- Verifique se há erros nos registros do servidor de gerenciamento em /opt/apigee/var/log/apigee/management-server.
- Faça uma chamada no Management Server para verificar se ele está funcionando corretamente.
- 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, você passa 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 Como 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 da API pode ser 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 da API.
- A porta no roteador do host virtual. Normalmente, essas portas começam em 9001 e são incrementadas em um para cada novo host virtual.
- O alias 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 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, uma solicitação cURL para uma API por meio desse host virtual poderá usar um dos seguintes formatos:
- 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 de DNS para myapis.apigee.net:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
No segundo formulário, você especifica o endereço IP do roteador e transmite o alias do host no cabeçalho "Host".
Observação: o comando curl, a maioria dos navegadores e muitos outros utilitários anexam automaticamente o cabeçalho Host com o domínio como parte da solicitação. Portanto, é possível usar um comando curl no formato:
curl http://<routerIP>: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 para o endereço IP do roteador e a porta do host virtual, como <routerIP>:porta. Exemplo:
192.168.1.31:9001
Ao fazer 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 de cada roteador e a porta do host virtual.
Como alternativa, defina o alias do host como um valor, como temp.hostalias.com. Em seguida, transmita 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 você tivesse uma entrada de DNS:
curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}