Esta página foi traduzida pela API Cloud Translation.

Integrar uma organização

Edge for Private Cloud v. 4.17.01

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

Como parte do processo de integração, o script:

Cria a organização.
Define o usuário especificado como o administrador da organização.
- Este usuário deve ser diferente do usuário administrador sys. ou seja, não use o sysadmin usuário administrador da organização.
- É possível especificar um usuário atual para o administrador da organização ou configurar o script para criar um novo usuário.
Associa a organização a um pod. Por padrão, ele é associado ao "gateway" bando
Crie um ambiente.
Crie um host virtual para o ambiente.
Associar o ambiente a todos os processadores de mensagens.
Permite análises.

Arquivo de configuração para integração

Transmita um arquivo de configuração para o comando setup-org. Invoque o comando setup-org e especifique a opção -f. incluindo o caminho para o arquivo de configuração silencioso:

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

A única exigência em instalações silenciosas é que o arquivo de configuração precise estar acessível ou pode ser lido pelo usuário.

Veja abaixo um exemplo de arquivo de configuração silenciosa. Edite-o conforme necessário para sua requisitos:

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=adminPassword     # 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
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

# 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ê não ainda tiver um registro DNS, poderá usar o endereço IP do roteador.

Para mais informações sobre como configurar o host virtual, consulte Requisitos de instalação da demonstração do Edge.
Para configuração TLS/SSL, consulte Keystores e Truststores e Como configurar o acesso TLS a um API para a nuvem privada para mais informações sobre como criar o arquivo JAR e outros aspectos da configuração de TLS/SSL.

Procedimento de integração

Instale o apigee-provision em nó do servidor de gerenciamento:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
Execute o comando 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 estar acessível ou pode ser lido pelo usuário.

Verificação de integração

Após a conclusão da integração, verifique o status do sistema emitindo o seguinte CURL no nó do servidor de gerenciamento.

Verifique o status do usuário e da organização no servidor de gerenciamento emitindo o seguinte Comandos CURL:
> curl -u <adminEmail>:<senha do administrador> http://localhost:8080/v1/users
> curl -u <e-mail do administrador>:<passwd do administrador> http://localhost:8080/v1/organizations
> curl -u <e-mail do administrador>:<passwd do administrador> http://localhost:8080/v1/organizations/<orgname>/deployments
Se você ativou o Google Analytics, use este comando:
> curl -u <adminEmail>:<senha do administrador> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
Você também pode verificar o status do banco de dados PostgreSQL executando o seguinte comando em Máquina 2 para iniciar psql:
> 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:
apigee=# : \d analytics."<orgname>.prod.fact"

Use o seguinte comando para sair do psql:
apigee=# \q
Acesse a interface do usuário do Apigee Edge usando um navegador da Web. Lembre-se de que você já observou o URL 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 a Máquina 1 ou para a máquina que você instalou a interface ativada 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 de borda, use um URL no formato:
  http://localhost:9000/login
  
  Observação: verifique se a porta 9000 está aberta.
2. Na página de login do console, especifique o nome de usuário/senha do administrador do sistema da Apigee.
  Observação: essa é a senha de administrador global do sistema que você definiu. durante a instalação. Você também pode fazer o seguinte:
Crie uma nova conta de usuário da Apigee e faça login com a nova credencial de usuário.
1. Clique em "Fazer login". O navegador redirecionará para:
  http://192.168.56.111:9000/platform/#/<orgname>/
  
  e abre um painel que permite configurar a organização criada anteriormente (se fez login usando credenciais de administrador da Apigee).
2. Se você estiver começando a usar o Edge, agora poderá criar seu primeiro proxy de API. Para mais informações, consulte Criar seu primeiro proxy de API.
  
  Consulte também as seções sobre amostras, incluindo a Lista de amostras e o objetivo simulado. APIs RESTful que você pode usar nos seus próprios experimentos de criação de API na API Mock Target.