Incorpore una organización

Edge para la nube privada v4.18.05

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

Para integrar una organización, sigue estos pasos:

  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:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
    .

    El usuario de “apigee” debe poder leer el archivo de configuración. Para obtener un archivo de configuración de ejemplo, consulta el archivo de configuración de integración.

  3. Verifica si integraste 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

    Donde IP_address es la dirección IP del servidor en el que instalaste la IU de Edge.

    Para ver más pasos de verificación, consulta Verifica la integración.

  4. Crea tu primer proxy.

Archivo de configuración de integración

Para realizar una configuración silenciosa con la secuencia de comandos setup-org, pasa un archivo de configuración con la opción -f, como se muestra en el siguiente ejemplo:

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

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

Cuando se integra una organización, la secuencia de comandos 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 “puerta de enlace”. (Esta es la opción predeterminada y no se puede cambiar).
  • Asocia el entorno con todos los procesadores de mensajes.
  • Habilita las estadísticas.

Copia el siguiente ejemplo y edítalo según sea necesario para integrar a 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.

Notas:

Si deseas obtener más información sobre el uso de la API de Management para integrar una organización, consulta Crea una organización, un entorno y un host virtual.

Verifica la integración

Cuando finalice la integración, verifica el estado del sistema mediante la emisión de los siguientes comandos CURL en el nodo del servidor de administración:

  1. Ejecuta los siguientes comandos para verificar el estado del usuario 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. Para verificar las estadísticas, ejecuta el siguiente comando:
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. Verifica el estado de la base de datos de PostgreSQL mediante la ejecución de los siguientes comandos en el Nodo 2 (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. Accede a la IU de Apigee Edge con 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. Es 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 con el siguiente formato:

      http://localhost:9000/login

    2. En la página de acceso de la consola, especifica el nombre de usuario y la contraseña del administrador del sistema de Apigee.
  5. Regístrate para obtener una cuenta de usuario nueva de Apigee y usa la credencial de usuario nueva 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 las credenciales de administrador de Apigee).

Crea tu primer proxy

Después de incorporar una organización nueva y verificar que el proceso de integración se realizó correctamente, puedes crear tu primer proxy. Para obtener más información, consulta Cómo compilar tu primer proxy de API.

Otros recursos que pueden resultarte útiles incluyen los siguientes: