Esta página foi traduzida pela API Cloud Translation.

Integrar uma organização

Edge para nuvem privada v4.18.05

Use o script setup-org para realizar o processo de integração. É necessário executar o script no nó do servidor de gerenciamento.

Para integrar uma organização:

Instale apigee-provision no nó do servidor de gerenciamento:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision install

Execute o script setup-org no nó do servidor de gerenciamento:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
```
O arquivo de configuração precisa ser legível pelo usuário "apigee". Para conferir um exemplo de arquivo de configuração, consulte Arquivo de configuração de integração.
Verifique se você integrou uma organização. Uma maneira de fazer isso é fazer login na interface solicitando o seguinte URL em um navegador:
```
http://IP_address:9000/login
```
Em que IP_address é o endereço IP do servidor em que você instalou a interface do Edge.

Para conferir outras etapas de verificação, consulte Verificar a integração.
Crie seu primeiro proxy.

Arquivo de configuração de integração

Para executar uma configuração silenciosa com o script setup-org, transmita um arquivo de configuração com a opção -f, conforme mostrado no exemplo abaixo:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

Esta seção inclui um arquivo de configuração de exemplo para integração de uma organização com setup-org.

Ao integrar uma organização, o script setup-org faz o seguinte:

Cria uma nova organização.
Cria um ambiente.
Cria um host virtual para o ambiente.
Define o usuário especificado como administrador da organização. Algumas considerações:
- Você pode usar um usuário existente ou criar um novo para o administrador da organização.
- O administrador da organização não pode ser o mesmo que o administrador de sistema.
Associa a organização ao pod "gateway". Esse é o padrão e não pode ser alterado.
Associa o ambiente a todos os processadores de mensagens.
Ativa a análise.

Copie o exemplo a seguir e edite conforme necessário para integrar sua organização:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.

# Specify organization name.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

# Specify the organization administrator user.
# Either specify an existing user, or specify the information
# necessary to create a new user.
# Do not use the sys admin as the organization administrator.
#
# Create a new user for the organization administrator.
NEW_USER="y"
# New user information if NEW_USER="y".
USER_NAME=new@user.com
FIRST_NAME=new
LAST_NAME=user
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
USER_PWD="newUserPword"
ORG_ADMIN=new@user.com
#
# Or, specify an existing user as the organization admin,
# omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD.
# NEW_USER="n"
# ORG_ADMIN=existing@user.com

# Specify environment name.
ENV_NAME=prod  # lowercase only

# Specify virtual host information.
VHOST_PORT=9001
VHOST_NAME=default

# If you have a DNS entry for the virtual host.
VHOST_ALIAS=myorg-test.apigee.net

# If you do not have a DNS entry for the virtual host,
# specify the IP and port of each router as a space-separated list:
# VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001"

# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore.
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one.

# Specify the analytics group.
# AXGROUP=axgroup-001 # Default name is axgroup-001.

Observações:

Para VHOST_ALIAS, se você já tiver um registro DNS que será usado para acessar o host virtual, especifique o alias do host e, opcionalmente, a porta, por exemplo, "myapi.example.com". Se você ainda não tiver um registro DNS, use o endereço IP do roteador.

Para saber mais sobre como configurar o host virtual, consulte Configurar um host virtual.
Para a configuração TLS/SSL, consulte Keystores e Truststores e Como configurar o acesso TLS a uma API para a nuvem privada para mais informações sobre como criar o arquivo JAR e outros aspectos da configuração de TLS/SSL.
Para mais informações sobre como configurar hosts virtuais, consulte Como configurar o acesso TLS a uma API para a nuvem privada.
Não é possível criar duas organizações com o mesmo nome. Nesse caso, a segunda criação falhará.

Para mais informações sobre como usar a API de gerenciamento para integrar uma organização, consulte Criar uma organização, um ambiente e um host virtual.

Verificar a integração

Após a conclusão da integração, verifique o status do sistema emitindo os seguintes comandos CURL no nó do servidor de gerenciamento:

Verifique o status do usuário e da organização no servidor de gerenciamento executando os seguintes 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/org_name/deployments

Verifique as análises executando o seguinte comando:

curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus

Verifique o status do banco de dados PostgreSQL executando os seguintes comandos no nó 2 (conforme mostrado nas topologias de instalação):
```
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
```
No prompt de comando, digite o seguinte comando para conferir a tabela de análise da sua organização:
```
\d analytics."org_name.env_name.fact"
```
Use o comando abaixo para sair do psql:
```
\q
```
Acesse a interface do Apigee Edge usando um navegador da Web. Você já anotou o URL do console de gerenciamento no final da instalação.
1. Inicie o navegador de sua preferência e insira o URL da interface do Edge. Ela é semelhante à seguinte, em que o endereço IP é do nó 1 (conforme mostrado nas topologias de instalação) ou de qualquer outro em que você instalou a IU para configurações alternativas:
```
http://192.168.56.111:9000/login
```
  9000 é o número da porta usado pela interface.
  
  Se você estiver iniciando o navegador diretamente no servidor que hospeda a IU de borda, poderá usar um URL no formato:
```
http://localhost:9000/login
```
  Observação: verifique se a porta 9000 está aberta. Se você estiver usando um serviço como o Google Cloud Engine, talvez seja necessário modificar as regras do firewall para acessar os serviços da Apigee por um navegador.
2. Na página de login do console, especifique o nome de usuário/senha do administrador do sistema Apigee.
  Observação: essa é a senha de administrador do sistema global que você definiu durante a instalação.
Crie uma nova conta de usuário da Apigee e faça login com a nova credencial de usuário. Na página de login do console, clique no botão Sign In.

O navegador redireciona para http://192.168.56.111:9000/platform/#/org_name/ e abre um painel que permite configurar a organização que você criou (se você fez login usando credenciais de administrador da Apigee).

Criar seu primeiro proxy

Depois de concluir a integração de uma nova organização e verificar se o processo foi bem-sucedido, você pode criar seu primeiro proxy. Para mais informações, consulte Criar seu primeiro proxy de API.

Outros recursos que podem ser úteis incluem: