Incorpore una organización

Edge para nube privada v. 4.16.05

Usa el comando setup-org para realizar el proceso de integración. Debes ejecutar el comando en el nodo del servidor de administración.

Como parte del proceso de integración, la secuencia de comandos hace lo siguiente:

De forma opcional, crea un usuario nuevo para que funcione como administrador de la organización.

  • Crea la organización.
  • Agrega al usuario especificado como administrador de la organización. El usuario ya debe existir; de lo contrario, la secuencia de comandos emite un error.
  • Asocia la organización con un Pod, de forma predeterminada, la asocia con el Pod de “puerta de enlace”.
  • Crea un entorno.
  • Crear un host virtual para el entorno
  • Asocia el entorno con todos los procesadores de mensajes.
  • Habilita las estadísticas.

Archivo de configuración silencioso para la integración

Pasa un archivo de configuración al comando setup-org. Invoca el comando setup-org y especifica la opción -f, incluida la ruta de acceso al archivo de configuración silencioso:

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

El único requisito en las instalaciones silenciosas es que el usuario de “Apigee” debe poder acceder al archivo de configuración o leerlo. Por ejemplo, coloca el archivo en el directorio /tmp del nodo.

A continuación, se muestra un ejemplo de un archivo de configuración silencioso. Edítalo según sea necesario para tus requisitos:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # If omitted, you are prompted for it.

# Specify organization name and administrator.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

#
# Set the organization administrator.
# Do not use sys admin as 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

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

Notas:

  • Para VHOST_ALIAS, si ya tienes un registro DNS que usarás para acceder al host virtual, especifica el alias del host y, de forma opcional, el puerto, por ejemplo, "myapi.example.com".

    Si aún no tienes un registro DNS, consulta cómo configurar un host virtual para obtener más información.
  • Para obtener más información sobre cómo crear el archivo JAR y otros aspectos de la configuración de TLS/SSL, consulta Almacenes de claves y almacenes de confianza y Configura TLS/SSL para la configuración de TLS/SSL.

Integración

  1. Instala apigee-provision en el nodo del servidor de administración:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Ejecuta el comando 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 acceder al archivo de configuración o leerlo. Por ejemplo, coloca el archivo en el directorio /tmp del nodo.

Verificación de integración

Cuando se complete 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. Verifica el estado del usuario y la organización en el servidor de administración. Para ello, ejecuta los siguientes comandos CURL:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/admins>8080/v1/admins>8.
  2. Si habilitaste Analytics, usa este comando:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/creating/axstatus
  3. También puedes verificar el estado de la base de datos de PostgreSQL mediante la ejecución del siguiente comando en la máquina 2 para iniciar PSQL:
    >ppr -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:
    apigee=# : \factd analytics."<orgname>.


  4. Accede a la interfaz de usuario 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 la Máquina 1 o en cualquier máquina en la que hayas instalado 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

      Nota: Asegúrate de que el puerto 9000 esté abierto.
    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.
      Nota: Esta es la contraseña global del administrador del sistema que estableciste durante la instalación. Si lo prefieres, puedes hacer lo siguiente:
  5. Regístrate para obtener una cuenta de usuario nueva de Apigee y usa la credencial de usuario nueva para acceder.
    1. Haz clic en Acceder, el navegador lo redireccionará a:
      http://192.168.56.111:9000/platform/#/<orgname>/

      y se abrirá un panel que te permitirá configurar la organización que creaste antes (si accediste con las credenciales de administrador de Apigee).
    2. Si es la primera vez que usas Edge, ahora puedes crear tu primer proxy de API. Para obtener más información, consulta Cómo compilar tu primer proxy de API.