Esta página foi traduzida pela API Cloud Translation.

Integrar uma organização

Para integrar uma organização, você precisa criar e transmitir um arquivo de configuração de integração ao comando setup-org. Cada uma dessas etapas é descrita nas seções que seguir.

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

Criar um arquivo de configuração de integração

Esta seção inclui um exemplo de arquivo de configuração para integrar uma organização ao setup-org:

Copie o exemplo a seguir e faça as edições necessárias para 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 você usará para acessar o host virtual, especifique o host alias e, opcionalmente, a porta, por exemplo, "myapi.example.com". Se você ainda não tiver um DNS será possível usar o endereço IP do roteador.

Para mais informações sobre como configurar o host virtual, consulte Como configurar configure um host virtual.
Para configuração TLS/SSL, consulte Keystores e Truststores e Como configurar 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 obter mais informações sobre a configuração de hosts virtuais, consulte Como configurar o acesso TLS a um para a nuvem privada.
Não é possível criar duas organizações com o mesmo nome. Nesse caso, a segunda criação será falhar.

Executar setup-org

Depois de criar o arquivo de configuração de integração, transmita-o ao setup-org. script para executar o processo de integração. Você precisa executar o script no servidor de gerenciamento nó.

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 o administrador da organização. Observações:
- Use um usuário atual ou crie 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 "gateway" bando (Este é o padrão e não pode ser changed.)
Associa o ambiente a todos os processadores de mensagens.
Permite análises.

Para executar setup-org:

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 e aponte-o para arquivo de configuração criado em Criar uma configuração de integração arquivo:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
```
O arquivo de configuração precisa ser legível para o ambiente do Apigee usuário.
Verifique se você integrou uma organização com sucesso. Uma maneira de fazer isso é registrar 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 o Edge. de ML pela IU.

Confira outras etapas de verificação em Verificar a integração.
Crie seu primeiro proxy.

Verificar a integração

Após a integração, verifique o status do sistema emitindo o seguinte Comandos curl no nó do servidor de gerenciamento:

Verifique o status do usuário e da organização no servidor de gerenciamento executando o seguinte 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 a análise 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 do 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 comando a seguir para ver a tabela de análise da sua organização:
```
\d analytics."org_name.env_name.fact"
```
Use o seguinte comando para sair do psql:
```
\q
```
Acesse a IU do Apigee Edge usando um navegador da Web. Lembre-se de que você já anotou do console de gerenciamento no fim da instalação.
1. Abra seu navegador preferido e insira o URL da interface do Edge. Ela é semelhante à em que o endereço IP é para o Nó 1 (como mostrado no topologias de instalação) ou qualquer nó em que você instalou a IU para configurações alternativas:
```
http://192.168.56.111:9000/login
```
  9000 é o número da porta usada pela interface.
  
  Se você iniciar o navegador diretamente no servidor que hospeda a interface de usuário do Edge, pode usar um URL no formato:
```
http://localhost:9000/login
```
  Observação: verifique se a porta 9000 está aberta. Se você for usando um serviço como o Google Cloud Engine, talvez seja necessário modificar as regras de firewall para que os serviços da Apigee podem ser acessados usando um navegador.
2. Na página de login do console, especifique o nome de usuário/senha do administrador do sistema da Apigee.
  Observação: este é o administrador global do sistema. 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. No(s) dia(s) do console do Cloud, clique no botão Fazer login.

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ê no uso de credenciais de administrador da Apigee).

Criar seu primeiro proxy

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

Outros recursos que podem ser úteis incluem: