Eseguire l'onboarding di un'organizzazione

Edge per Private Cloud v4.19.01

Per eseguire l'onboarding di un'organizzazione, devi creare un file di configurazione di onboarding e poi passarlo al comando setup-org. Ciascuno di questi passaggi è descritto nelle sezioni seguire.

Per informazioni sull'utilizzo dell'API di gestione per l'onboarding di un'organizzazione, consulta Creando un'organizzazione, ambiente e host virtuale.

Crea un file di configurazione di onboarding

Questa sezione include un file di configurazione di esempio per l'onboarding di un'organizzazione con setup-org.

Copia il seguente esempio e apporta le modifiche necessarie per la tua organizzazione:

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.

Tieni presente che:

Esegui setup-org

Dopo aver creato il file di configurazione dell'onboarding, devi passarlo a setup-org per eseguire il processo di inserimento. Devi eseguire lo script sul server di gestione nodo.

Durante l'onboarding di un'organizzazione, lo script setup-org esegue le seguenti operazioni:

  • Crea una nuova organizzazione.
  • Crea un ambiente.
  • Crea un host virtuale per l'ambiente.
  • Imposta l'utente specificato come amministratore dell'organizzazione. Tieni presente che:
    • Puoi utilizzare un utente esistente o crearne uno nuovo per l'amministratore dell'organizzazione.
    • L'amministratore dell'organizzazione non deve essere uguale all'amministratore di sistema.
  • Associa l'organizzazione al "gateway" pod. Questa è l'impostazione predefinita e non può changed.)
  • Associa l'ambiente a tutti i processori di messaggi.
  • Abilita l'analisi.

Per eseguire setup-org:

  1. Installa apigee-provision sul nodo del server di gestione:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Esegui lo script setup-org sul nodo del server di gestione e puntalo verso di configurazione creato in Creare una configurazione di onboarding file:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    Il file di configurazione deve essere leggibile dall'"apigee" utente.

  3. Verifica di aver eseguito correttamente l'onboarding di un'organizzazione. Un modo per farlo è registrare nell'interfaccia utente richiedendo il seguente URL in un browser:
    http://IP_address:9000/login

    Dove IP_address è l'indirizzo IP del server su cui hai installato Edge nell'interfaccia utente.

    Per ulteriori passaggi di verifica, vedi Verificare l'onboarding.

  4. Crea il tuo primo proxy.

Verifica l'onboarding

Al termine dell'onboarding, verifica lo stato del sistema inviando quanto segue Comandi curl sul nodo del server di gestione:

  1. Verifica lo stato degli utenti e dell'organizzazione sul server di gestione eseguendo questa operazione: :
    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. Controlla le analisi eseguendo questo comando:
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. Controlla lo stato del database PostgreSQL eseguendo i seguenti comandi sul nodo 2 (come mostrato nelle topologie di installazione):
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    Al prompt dei comandi, inserisci questo comando per visualizzare la tabella di analisi per il tuo organizzazione:

    \d analytics."org_name.env_name.fact"

    Usa questo comando per uscire da psql:

    \q
  4. Accedi all'interfaccia utente di Apigee Edge utilizzando un browser web. Ricorda che hai già preso nota della console di gestione al termine dell'installazione.
    1. Avvia il tuo browser preferito e inserisci l'URL della UI di Edge. È simile dove l'indirizzo IP è del Nodo 1 (come mostrato topologie di installazione) o a qualsiasi nodo su cui installato l'interfaccia utente per configurazioni alternative:
      http://192.168.56.111:9000/login

      9000 è il numero di porta utilizzato dalla UI.

      Se avvii il browser direttamente sul server che ospita la UI Edge, possono utilizzare un URL nel formato

      http://localhost:9000/login
    2. Nella pagina di accesso della console, specifica il nome utente e la password dell'amministratore di sistema Apigee.
  5. Registrati per creare un nuovo account utente Apigee e utilizza le credenziali del nuovo utente per accedere. Il giorno pagina di accesso alla console, fai clic sul pulsante Accedi.

    Il browser reindirizza a http://192.168.56.111:9000/platform/#/org_name/ e apre una dashboard che consente di configurare l'organizzazione che hai creato (se hai registrato nell'utilizzo delle credenziali di amministratore di Apigee).

Crea il tuo primo proxy

Dopo aver eseguito l'onboarding di una nuova organizzazione e aver verificato che il processo di onboarding sia operazione riuscita, ora puoi creare il tuo primo proxy. Per maggiori informazioni, consulta Creare il primo proxy API.

Altre risorse che potrebbero esserti utili includono: