Incorpore una organización

Edge para la nube privada v4.19.01

Para integrar una organización, debes crear un archivo de configuración de integración y, luego, pasarlo al comando setup-org. Cada uno de estos pasos se describe en las siguientes secciones.

Para obtener información sobre cómo usar la API de administración para incorporar una organización, consulta Cómo crear una organización, un entorno y un host virtual.

Crea un archivo de configuración de integración

En esta sección, se incluye un archivo de configuración de muestra para integrar una organización con setup-org.

Copia el siguiente ejemplo y edítalo según sea necesario para tu organización:

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.

Ten en cuenta lo siguiente:

  • Para VHOST_ALIAS, si ya tienes un registro DNS que usarás para acceder al host virtual, especifica el alias de host y, de manera opcional, el puerto, por ejemplo, "myapi.example.com". Si aún no tienes un registro DNS, puedes usar la dirección IP del router.

    Para obtener más información sobre cómo configurar el host virtual, consulta Configura un host virtual.

  • Para la configuración de TLS/SSL, consulta Repositorios de claves y de confianza y Configura el acceso de TLS a una API para la nube privada para obtener más información sobre la creación del archivo JAR y otros aspectos de la configuración de TLS/SSL.
  • Si deseas obtener más información sobre la configuración de hosts virtuales, consulta Configura el acceso TLS a una API para la nube privada.
  • No puedes crear dos organizaciones con el mismo nombre. En ese caso, la segunda creación fallará.

Ejecuta setup-org

Después de crear el archivo de configuración de integración, pásalo a la secuencia de comandos setup-org para realizar el proceso de integración. Debes ejecutar la secuencia de comandos en el nodo del servidor de administración.

Cuando se integra una organización, la secuencia de comandos de setup-org hace lo siguiente:

  • Crea una organización nueva.
  • Crea un entorno.
  • Crea un host virtual para el entorno.
  • Establece al usuario especificado como administrador de la organización. Ten en cuenta lo siguiente:
    • Puedes usar un usuario existente o crear uno nuevo para el administrador de la organización.
    • El administrador de la organización no debe ser el mismo que el administrador del sistema.
  • Asocia la organización con el pod de "puerta de enlace". (Esta es la configuración predeterminada y no se puede cambiar).
  • Asocia el entorno con todos los procesadores de mensajes.
  • Habilita las estadísticas.

Para ejecutar setup-org, haz lo siguiente:

  1. Instala apigee-provision en el nodo del servidor de administración: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Ejecuta la secuencia de comandos setup-org en el nodo del servidor de administración y diríjela al archivo de configuración que creaste en Crea un archivo de configuración de integración: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    El usuario "apigee" debe poder leer el archivo de configuración.

  3. Verifica que hayas incorporado correctamente una organización. Una forma de hacerlo es acceder a la IU solicitando la siguiente URL en un navegador: 
    http://IP_address:9000/login

    En el ejemplo anterior, IP_address es la dirección IP del servidor en el que instalaste la IU de Edge.

    Para conocer otros pasos de verificación, consulta Cómo verificar la integración.

  4. Crea tu primer proxy

Verifica la integración

Cuando finalices la integración, verifica el estado del sistema mediante la ejecución de los siguientes comandos curl en el nodo del servidor de administración:

  1. Ejecuta los siguientes comandos para verificar el estado de los usuarios y la organización en el servidor de administración: 
    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. Ejecuta el siguiente comando para verificar las estadísticas: 
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. Ejecuta los siguientes comandos en el nodo 2 para verificar el estado de la base de datos de PostgreSQL (como se muestra en las topologías de instalación): 
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    En el símbolo del sistema, ingresa el siguiente comando para ver la tabla de estadísticas de tu organización:

    \d analytics."org_name.env_name.fact"

    Usa el siguiente comando para salir de psql:

    \q
  4. Acceder a la IU de Apigee Edge a través de un navegador web Recuerda que ya anotaste la URL de la consola de administración al final de la instalación.
    1. Inicia tu navegador preferido y, luego, ingresa la URL de la IU de Edge. Se ve similar al siguiente, en el que la dirección IP es para el nodo 1 (como se muestra en las topologías de instalación) o cualquier nodo en el que instalaste la IU para configuraciones alternativas: 
      http://192.168.56.111:9000/login

      9000 es el número de puerto que usa la IU.

      Si inicias el navegador directamente en el servidor que aloja la IU de Edge, puedes usar una URL del siguiente formato: 

      http://localhost:9000/login

    2. En la página de acceso de la consola, especifica el nombre de usuario o la contraseña del administrador del sistema de Apigee.
  5. Regístrate para obtener una nueva cuenta de usuario de Apigee y usa la nueva credencial de usuario para acceder. En la página de acceso de la consola, haz clic en el botón Acceder.

    El navegador redirecciona a http://192.168.56.111:9000/platform/#/org_name/ y abre un panel que te permite configurar la organización que creaste (si accediste con credenciales de administrador de Apigee).

Crea tu primer proxy

Una vez que hayas integrado una organización nueva y hayas verificado que el proceso de integración fue exitoso, podrás crear tu primer proxy. Para obtener más información, consulta Compila tu primer proxy de API.

Estos son otros recursos que podrían resultarte útiles: