Eseguire l'onboarding di un'organizzazione

Edge for Private Cloud v. 4.16.05

Utilizza il comando setup-org per eseguire il processo di onboarding. Devi eseguire il comando sul nodo del server di gestione.

Nell'ambito del processo di onboarding, lo script:

(Facoltativo) Crea un nuovo utente che funga da amministratore dell'organizzazione.

  • Crea l'organizzazione.
  • Aggiunge l'utente specificato come amministratore dell'organizzazione. L'utente deve già esistere, altrimenti lo script genera un errore.
  • Associa l'organizzazione a un pod, per impostazione predefinita al pod "gateway".
  • Crea un ambiente.
  • Crea un host virtuale per l'ambiente.
  • Associa l'ambiente a tutti i processori di messaggi.
  • Abilita l'analisi.

File di configurazione silenziosa per l'onboarding

Passa un file di configurazione al comando setup-org. Richiama il comando setup-org e specifica l'opzione -f, incluso il percorso del file di configurazione silent:

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

L'unico requisito per le installazioni invisibili è che il file di configurazione deve essere accessibile o leggibile dall'utente "apigee". Ad esempio, inserisci il file nella directory /tmp del nodo.

Di seguito è riportato un esempio di file di configurazione invisibile all'utente. Modificalo in base alle tue esigenze:

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.

Note:

  • Per VHOST_ALIAS, se hai già un record DNS che utilizzerai per accedere all'host virtuale, specifica l'alias host e, facoltativamente, la porta, ad esempio "myapi.example.com".

    Se non hai ancora un record DNS, consulta Configurazione di un host virtuale per ulteriori informazioni.
  • Per la configurazione TLS/SSL, consulta Keystore e truststore e Configurazione di TLS/SSL per Edge on-premise per ulteriori informazioni sulla creazione del file JAR e su altri aspetti della configurazione di TLS/SSL.

Onboarding

  1. Installa apigee-provision sul nodo del server di gestione:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. Esegui il comando sul nodo del server di gestione:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    Il file di configurazione deve essere accessibile o leggibile dall'utente "apigee". Ad esempio, inserisci il file nella directory /tmp sul nodo.

Verifica di onboarding

Al termine dell'onboarding, verifica lo stato del sistema eseguendo i seguenti comandi CURL sul nodo del server di gestione.

  1. Controlla lo stato dell'utente e dell'organizzazione sul server di gestione eseguendo i seguenti comandi 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. Se hai attivato Analytics, utilizza questo comando:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. Puoi anche controllare lo stato del database PostgreSQL eseguendo questo comando sulla macchina 2 per avviare psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    Al prompt dei comandi, inserisci il comando seguente per visualizzare la tabella di analisi per la tua organizzazione:
    apigee=# : \d analytics."<orgname>.prod.fact"

    Utilizza il comando seguente per uscire da psql:
    apigee=# \q
  4. Accedi all'interfaccia utente di Apigee Edge utilizzando un browser web. Ricorda che hai già annotato l'URL della console di gestione alla fine dell'installazione.
    1. Avvia il browser che preferisci e inserisci l'URL della UI Edge. L'URL è simile al seguente, dove l'indirizzo IP è quello della Macchina 1 o di qualsiasi macchina su cui hai installato l'interfaccia utente per configurazioni alternative:
      http://192.168.56.111:9000/login

      9000 è il numero di porta utilizzato dall'interfaccia utente. Se avvii il browser direttamente sul server che ospita la UI di Edge, puoi utilizzare un URL nel formato:
      http://localhost:9000/login

      Nota: assicurati che la porta 9000 sia aperta.
    2. Nella pagina di accesso alla console, specifica il nome utente e la password dell'amministratore di sistema Apigee.
      Nota: questa è la password dell'amministratore di sistema globale che hai impostato durante l'installazione. In alternativa, puoi:
  5. Registrati per un nuovo account utente Apigee e utilizza le nuove credenziali utente per accedere.
    1. Fai clic su Accedi. Il browser reindirizza a:
      http://192.168.56.111:9000/platform/#/<orgname>/

      e apre una dashboard che ti consente di configurare l'organizzazione creata in precedenza (se hai eseguito l'accesso utilizzando le credenziali di amministratore di Apigee).
    2. Se non hai mai utilizzato Edge, ora puoi creare il tuo primo proxy API. Per saperne di più, consulta Crea il tuo primo proxy API.