Esta página foi traduzida pela API Cloud Translation.

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

Edge para nuvem privada v4.19.01

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 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 Management Server desempenha um papel vital na manutenção de todos os outros componentes juntos em uma instalação local da nuvem privada de borda. É possível 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 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 para o 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 mostrados abaixo usam um arquivo de configuração como entrada. Por exemplo, você transmite 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 conferir 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 no Edge define os domínios e as portas do Edge Router 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 referenciá-lo 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 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 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 de myapis.apigee.net na porta 9001, execute uma solicitação curl para uma API usando esse host virtual em 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 DNS para myapis.apigee.net:
```
curl http://routerIP:9001/proxy-base-path/resource-path -H 'Host: myapis.apigee.net'
```
Na segunda forma, 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: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 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 seu 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