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

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 de implantação no servidor de gerenciamento emitindo o seguinte curl comandos:

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:

  1. Verifique os registros do Management Server em /opt/apigee/var/log/apigee/management-server se há erros.
  2. Fazer uma chamada no Management Server 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 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 e execute uma Uma solicitação curl para uma API por meio desse host virtual pode usar uma das seguintes opções: 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.

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

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.

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.

Você também pode definir o alias de host com um valor, como temp.hostalias.com. Em seguida, você precisa 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 seu arquivo /etc/hosts. Por exemplo, adicione esta linha /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