Edge para nuvem privada v. 4.17.05
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. Você pode 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:
- Verifique se há erros nos registros do Servidor de gerenciamento em /opt/apigee/var/log/apigee/management-server.
- Faça uma chamada no Servidor de gerenciamento 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 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 da determinação do 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 o alias myapis.apigee.net na porta 9001, uma solicitação cURL para uma API por esse host virtual poderá usar uma das seguintes formas:
- Se houver uma entrada DNS para myapis.apigee.net:
curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path} - Se não houver uma entrada 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, para que você possa 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 como o endereço IP do roteador e a porta do host virtual, como <routerIP>:port. Exemplo:
192.168.1.31:9001
Ao criar 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 um deles e a porta do host virtual.
Outra opção é 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}