Esta página foi traduzida pela API Cloud Translation.

Integrar uma organização

Edge para nuvem privada v4.19.01

Para integrar uma organização, crie um arquivo de configuração de integração e transmita-o ao comando setup-org. Cada uma dessas etapas é descrita nas seções a seguir.

Para 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.

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 edite conforme necessário 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 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 mais informações sobre como configurar o host virtual, consulte Como configurar um host virtual.
Para a configuração de TLS/SSL, consulte Armazenamentos de chaves e armazenamentos de confiança e Configurar o acesso de TLS a uma API para a nuvem privada para mais informações sobre a criação do 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 vai falhar.

Executar setup-org

Depois de criar o arquivo de configuração de integração, transmita-o ao script setup-org para realizar o processo de integração. É necessário executar o script no nó do servidor de gerenciamento.

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. Observaçõ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.

Para executar setup-org:

Instale o 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 direcione-o ao arquivo de configuração que você criou em Criar um arquivo de configuração de integração:
```
/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
```
O arquivo de configuração precisa ser legível para o usuário "apigee".
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.

Verificar a integração

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

Para verificar o status do usuário e da organização no servidor de gerenciamento, execute 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 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 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. Lembre-se de que 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. Ele é semelhante ao exemplo a seguir, em que o endereço IP é para o Nó 1 (como mostrado nas 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 usado pela interface.
  
  Se você estiver iniciando o navegador diretamente no servidor que hospeda a interface do Edge, 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.
Inscreva-se para uma nova conta de usuário da Apigee e use a nova credencial do usuário para fazer login. 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 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 úteis incluem: