Incorpore una organización

Edge for Private Cloud v4.18.05

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

Sigue estos pasos para integrar una organizació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 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 archivo de configuración debe ser legible por el “Apigee” usuario. Para ver una configuración de ejemplo consulta Archivo de configuración de integración.

3. Verifica que hayas integrado correctamente una organización. Una forma de hacer esto es registrar a la IU solicitando la siguiente URL en un navegador:

   http://IP_address:9000/login

   En el ejemplo anterior, IP_address es la dirección IP del servidor en el que instalaste el dispositivo perimetral. de la IU de Google.

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

4. Crea tu primer proxy.

Archivo de configuración de la integración

Para realizar una configuración silenciosa con la secuencia de comandos setup-org, pasa una 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 ejemplo para integrar una organización con setup-org

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

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

• Durante VHOST_ALIAS, si un registro DNS que usarás para acceder al host virtual, especifica el host alias y, de forma opcional, el puerto, por ejemplo, “myapi.example.com”. Si aún no tienes un DNS, haz lo siguiente: puedes usar la dirección IP del router.
  

  Para obtener más información sobre cómo configurar el host virtual, consulta Configura el configurar un host virtual.

• Para la configuración de TLS/SSL, consulta almacenes de claves y Almacenes de confianza y Configuración Acceso 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.
• Para obtener más información sobre la configuración de hosts virtuales, consulta Configurar el acceso TLS a un API para la nube privada.
• No puedes crear dos organizaciones con el mismo nombre. En ese caso, la segunda creación fallan.

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

Verifica la integración

Cuando finalice la integración, emite el siguiente CURL para verificar el estado del sistema comandos en el nodo del servidor de administración:

1. Ejecuta el siguiente comando para verificar el estado de los usuarios y la organización en el servidor de administración: 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. Ejecuta el siguiente comando para verificar las estadísticas:

   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 ejecutando 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. Acceder a la IU de Apigee Edge mediante 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 parece al a continuación, donde la dirección IP es para el Nodo 1 (como se muestra en el 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, entonces puedes usar una URL en el 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 nueva cuenta de usuario de Apigee y usa la nueva credencial de usuario para acceder. En la 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 registraste en el uso de credenciales de administrador de Apigee).

Crea tu primer proxy

Después de incorporar una nueva organización y verificar que el proceso de integración se con éxito, ahora puedes crear tu primer proxy. Para obtener más información, consulta Compila tu primer proxy de API.

Estos son otros recursos que podrían resultarte útiles:

• Lista de muestras
• API de RESTful de destino de prueba que puedes usar en tus propios experimentos de compilación de APIs