Integrar uma organização

Edge para nuvem privada v. 4.17.05

Use o comando setup-org para executar o processo de integração. Execute 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.
    • Esse usuário precisa ser diferente do usuário administrador do sistema. Ou seja, não use o usuário administrador do sistema como administrador da organização.
    • Especifique um usuário atual para o administrador da organização ou configure o script para criar um novo usuário.
  • Associa a organização a um pod. Por padrão, é associado ao pod "gateway".
  • Crie um ambiente.
  • Crie um host virtual para o ambiente.
  • Associe o ambiente a todos os processadores de mensagens.
  • Possibilita 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

O único requisito em instalações silenciosas é que o arquivo de configuração precisa estar acessível ou legível pelo usuário "apigee".

Veja abaixo um exemplo de arquivo de configuração silenciosa. Edite conforme necessário para seus 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:

Procedimento de integração

  1. Instale o apigee-provision no nó do Servidor de gerenciamento:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. 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 legível pelo usuário "apigee".

Verificação de 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.

  1. Verifique o status do usuário e da organizaçã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/organizationEmails/deployment10
    > curlvorg/deployment1>:
  2. Se você ativou o Analytics, use este comando:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/atuais/axstatus
  3. Também é possível verificar o status do banco de dados PostgreSQL executando o seguinte comando na Máquina 2 para iniciar o HBase:
    >Apigee -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    No prompt de comando, digite o seguinte comando para visualizar a tabela de análise da organização:
    apigee=# : \d prod.


  4. Acesse a interface do usuário 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 seu navegador e insira o URL da interface do Edge. Ele é semelhante ao exemplo a seguir, em que o endereço IP é da Máquina 1 ou da máquina 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 IU. Se você estiver iniciando o navegador diretamente no servidor que hospeda a interface do Edge, 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 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:
  5. Inscreva-se em uma nova conta de usuário da Apigee e use a nova credencial de usuário para fazer login.
    1. Clique em "Fazer login", o navegador redireciona para:
      http://192.168.56.111:9000/platform/#/<orgname>/

      e abre um painel que permite configurar a organização criada anteriormente, se tiver feito login usando as credenciais de administrador da Apigee.
    2. Se você nunca usou o Edge, poderá criar seu primeiro proxy de API. Para saber mais, consulte Criar seu primeiro proxy de API.

      Consulte também as seções sobre amostras, incluindo a Lista de amostras e as APIs RESTful simuladas que você pode usar nos seus próprios experimentos de criação de APIs na API Mock Target.