Edge for Private Cloud v. 4.16.05
Esta seção aborda várias operações administrativas, como criação, gerenciamento e Remoção de organizações, ambientes e hosts virtuais da Apigee em um Apigee Edge for Private instalação do Google Cloud.
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 dos usuários e da organização e meio ambiente
O Management Server desempenha um papel vital mantendo todos os outros componentes juntos em um instalação local da nuvem privada do Edge. É possível verificar os dados de usuário, organização e o status da implantação no servidor de gerenciamento executando 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 deve exibir o status HTTP 200 para todas as chamadas. Se isso falhar, faça o seguinte:
- Verifique os registros do servidor de gerenciamento em <inst_root>/apigee/var/log/apigee/management-server se há algum erro.
- Fazer uma chamada no Management Server para verificar se ele está funcionando corretamente.
- Remova o servidor do ELB e reinicie o servidor de gerenciamento:
/<inst_root>/apigee/bin/apigee-service reinicialização do management-server
Sobre o uso de arquivos de configuração
Os comandos mostrados abaixo recebem 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 host virtual.
Para um arquivo de configuração completo e informações sobre as propriedades que podem ser definidas na 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 Edge Router em que um proxy de API está expostos 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 será acessado pelo protocolo HTTP ou pela protocolo.
Use os scripts e as chamadas de API mostrados abaixo para criar um host virtual. Quando você cria host virtual, especifique as seguintes informações:
- o nome do host virtual usado para referenciá-lo na API; proxies.
- A porta no roteador do host virtual. Normalmente, essas portas começam a 9001 e incrementa em um para cada novo host virtual.
- O alias de host do host virtual. Normalmente, o nome DNS do servidor
host.
O Edge Router 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 lida com a solicitação. Ao fazer uma solicitação host virtual, especifique um nome de domínio que corresponda ao alias 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 do myapis.apigee.net na porta 9001, depois uma solicitação cURL para uma API por meio desse host virtual 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 passa o alias do host na Cabeçalho do host.
Observação: o comando curl, a maioria dos navegadores e muitos outros utilitários são ativados anexar o cabeçalho Host com o domínio como parte da solicitação, para que você possa usar um 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 de host como o endereço IP do Roteador e porta do host virtual, como <routerIP>:port. Exemplo:
192.168.1.31:9001
Quando você cria 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.
Caso você tenha vários roteadores, adicione um alias de host para cada um deles, especificando o endereço IP dos para cada roteador e porta do host virtual.
Como alternativa, você pode definir o alias de host com um valor, como temp.hostalias.com. Em seguida, você precisa passar 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 para /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}