Incorpore una organización

Edge para nube privada v. 4.16.05

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

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

De manera 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 genera un error.
  • Asocia la organización con un Pod. De forma predeterminada, la asocia con el Pod de "puerta de enlace".
  • Crea un entorno.
  • Crea un host virtual para el entorno.
  • Asocia el entorno con todos los Message Processors.
  • Habilita las estadísticas.

Archivo de configuración silencioso para la incorporació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 silenciosa:

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

El único requisito para las instalaciones silenciosas es que el usuario "apigee" pueda 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 archivo de configuración silenciosa. 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:

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

    Si aún no tienes un registro DNS, consulta Configura un host virtual para obtener más información.
  • Para la configuración de TLS/SSL, consulta Almacenes de claves y de confianza y Configura TLS/SSL para Edge local para obtener más información sobre cómo crear el archivo JAR y otros aspectos de 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 “apigee” debe poder acceder al archivo de configuración o leerlo. Por ejemplo, coloca el archivo en el directorio /tmp en el nodo.

Verificación de incorporación

Cuando se complete la incorporación, verifica el estado del sistema emitiendo los siguientes comandos CURL en el nodo del servidor de administración.

  1. Verifica el estado del usuario y de la organización en el servidor de administración con los siguientes comandos CURL:
    > 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/<orgname>/deployments
  2. Si habilitaste las estadísticas, usa este comando:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. También puedes verificar el estado de la base de datos de PostgreSQL ejecutando el siguiente comando en la máquina 2 para iniciar psql:
    > 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:
    apigee=# : \d analytics."<orgname>.prod.fact"

    Usa el siguiente comando para salir de psql:
    apigee=# \q
  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. Se verá similar a lo siguiente, en el que la dirección IP es para la máquina 1 o para 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 de administrador del sistema global que estableciste durante la instalación. Como alternativa, puedes hacer lo siguiente:
  5. Regístrate para obtener una cuenta de usuario de Apigee nueva y usa la credencial de usuario nueva para acceder.
    1. Haz clic en Acceder. El navegador se redirecciona a:
      http://192.168.56.111:9000/platform/#/<orgname>/

      y abre un panel que te permite configurar la organización creada antes (si conectaste con las credenciales de administrador de Apigee).
    2. Si eres nuevo en Edge, ahora puedes crear tu primer proxy de API. Para obtener más información, consulta Compila tu primer proxy de API.