Incorpore una organización

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

Para obtener información sobre el uso de la API de Management para incorporar una organización, consulta Crea una organización, un entorno y un host virtual.

Crea un archivo de configuración de incorporación

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

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

# Specify the IP or DNS name of the Management Server.
IP1=MANAGEMENT_SERVER_IP_ADDRESS

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 del 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 Almacenes de claves y almacenes de confianza y Configura el acceso 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.
• Para 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 incorporación, pásalo a la secuencia de comandos setup-org para realizar el proceso de incorporación. Debes ejecutar la secuencia de comandos en el nodo del servidor de administración.

Cuando se incorpora 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 el 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 "gateway". (Este es el valor predeterminado y no se puede cambiar).
• Asocia el entorno con todos los Message Processors.
• 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ígela al archivo de configuración que creaste en Crea un archivo de configuración de incorporación:

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

   El archivo de configuración debe ser legible para el usuario "apigee".

3. Verifica que hayas incorporado correctamente una organización. Una forma de hacerlo es acceder a la IU de New Edge solicitando la siguiente URL en un navegador:

   http://IP_address:3001

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

   Para obtener pasos de verificación adicionales, consulta Verifica la incorporación.

4. Crea tu primer proxy.

Verifica la incorporación

Cuando se complete la incorporación, verifica el estado del sistema ejecutando los siguientes curl comandos en el nodo del servidor de administración:

1. Para verificar el estado del usuario y la organización en el servidor de administración, ejecuta los siguientes comandos:

   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. Para verificar el estado de la base de datos de PostgreSQL, ejecuta 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 New Edge con un navegador web. Recuerda que ya anotaste la la URL de la consola de administración al final de la instalación.
   1. Inicia el navegador que prefieras y, luego, ingresa la URL de la IU de New Edge. Se ve similar a lo siguiente, donde 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 hayas instalado la IU de New Edge para configuraciones alternativas:

      http://192.168.56.111:3001

      3001 es el número de puerto predeterminado que usa la IU de New Edge.

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

      http://localhost:3001

   2. En la página de acceso a 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 las credenciales del usuario nuevo para acceder. En la página de acceso a la consola, haz clic en el botón Acceder.

   El navegador redirecciona a http://192.168.56.111:3001/edge 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

Después de incorporar una organización nueva y verificar que el proceso de incorporación se haya realizado correctamente, puedes crear tu primer proxy. Para obtener más información, consulta Compila tu primer proxy de API.

Otros recursos que podrían ser de utilidad incluyen los siguientes:

• Lista de Samples
• APIs de REST de destino simuladas que puedes usar en tus propios experimentos de creación de APIs