Integrar uma organização

Edge para nuvem privada v4.18.05

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

Para integrar uma organização:

  1. Instale apigee-provision no nó do servidor de gerenciamento:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. 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 estar legível para o usuário "apigee". Para um exemplo de arquivo de configuração, consulte Arquivo de configuração de integração.

  3. Verifique se você integrou uma organização. Uma maneira de fazer isso é fazendo login na IU 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 IU do Edge.

    Para conferir outras etapas de verificação, consulte Verificar a integração.

  4. 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 a seguir:

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

Esta seção inclui um exemplo de arquivo de configuração para integrar uma organização com o 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 o administrador da organização. Algumas considerações:
    • Você pode usar um usuário atual ou criar um novo para o administrador da organização.
    • O administrador da organização não pode ser o mesmo que o administrador do 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.
  • Possibilita análises.

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 mais informações sobre como usar a API de gerenciamento para integrar uma organização, consulte Como 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:

  1. 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
  2. Execute o seguinte comando para verificar a análise:
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. 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 visualizar a tabela de análise da sua organização:

    \d analytics."org_name.env_name.fact"

    Use o seguinte comando para sair do AppSheet:

    \q
  4. 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 seu navegador e insira o URL da interface do Edge. Ele é semelhante ao seguinte, em que o endereço IP é para o Nó 1 (conforme mostrado nas topologias de instalação) ou para qualquer nó em que você tenha instalado 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, use um URL no formato:

      http://localhost:9000/login

    2. Na página de login do console, especifique o nome de usuário/senha do administrador do sistema Apigee.
  5. Inscreva-se em uma nova conta de usuário da Apigee e use a nova credencial de usuário para fazer login. Na página de login do console, 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 criada (se você fez login usando as credenciais de administrador da Apigee).

Criar seu primeiro proxy

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

Outros recursos que podem ser úteis incluem: