Incorpore una organización

Edge para nube privada v. 4.16.09

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:

  • Crea la organización.
  • Establece el usuario especificado como administrador de la organización.
    • Este usuario debe ser diferente del usuario administrador del sistema. Es decir, no uses el usuario administrador del sistema como usuario administrador de la organización.
    • Puedes especificar un usuario existente para el administrador de la organización o configurar la secuencia de comandos para crear un usuario nuevo.
  • 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 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 configFile

El único requisito para las instalaciones silenciosas es que el usuario "apigee" pueda acceder al archivo de configuración o leerlo.

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 sys admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # 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
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

# 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 el acceso de TLS a una API para la nube privada 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.

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.

      Consulta también las secciones sobre muestras, incluida la Lista de muestras, y las APIs de RESTful de destino ficticias que puedes usar en tus propios experimentos de compilación de APIs en la API de destino ficticia.