Eseguire l'onboarding di un'organizzazione

Edge per Private Cloud v. 4.17.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:

  • Crea l'organizzazione.
  • Imposta l'utente specificato come amministratore dell'organizzazione.
    • Questo utente deve essere diverso dall'utente amministratore di sistema. Ciò significa che non utilizzare l'utente amministratore di sistema come utente amministratore dell'organizzazione.
    • Puoi specificare un utente esistente per l'amministratore dell'organizzazione o configurare lo script per creare un nuovo utente.
  • Associa l'organizzazione a un pod, per impostazione predefinita la associa al pod "gateway".
  • Crea un ambiente.
  • Creare un host virtuale per l'ambiente.
  • Associare l'ambiente a tutti i processori di messaggi.
  • Abilita l'analisi.

File di configurazione 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 silenziosa:

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

L'unico requisito per le installazioni invisibili è che il file di configurazione deve essere accessibile o leggibile dall'utente "apigee".

Di seguito è riportato un esempio di file di configurazione silenziosa. 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 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.

Note:

Procedura di 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".

Verifica delle operazioni preliminari

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

  1. Controlla lo stato degli utenti e delle organizzazioni sul server di gestione inviando i seguenti comandi CURL:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/organizations> > <curl/organizations>
  2. Se hai abilitato 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 il comando seguente sulla macchina 2 per avviare psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

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


  4. Accedi all'interfaccia utente di Apigee Edge tramite un browser web. Ricorda che hai già annotato l'URL della console di gestione alla fine dell'installazione.
    1. Avvia il tuo browser preferito e inserisci l'URL dell'UI Edge. È simile al seguente, in cui l'indirizzo IP è per la macchina 1 o per qualsiasi macchina su cui hai installato l'interfaccia utente per le 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 Edge, puoi utilizzare un URL nel formato:
      http://localhost:9000/login

      Nota: assicurati che la porta 9000 sia aperta.
    2. Nella pagina di accesso della console, specifica il nome utente e la password dell'amministratore di sistema Apigee.
      Nota: questa è la password di amministratore di sistema globale che hai impostato durante l'installazione. In alternativa, puoi:
  5. Registrati per un nuovo account utente Apigee e utilizza la nuova credenziale 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 consente di configurare l'organizzazione creata in precedenza (se hai eseguito l'accesso utilizzando le credenziali amministrative di Apigee).
    2. Se non hai mai utilizzato Edge, ora puoi creare il tuo primo proxy API. Per maggiori informazioni, consulta la pagina su come creare il tuo primo proxy API.

      Consulta anche le sezioni degli esempi, tra cui l'elenco di esempi, e le API RESTful target fittizie che puoi utilizzare nei tuoi esperimenti di creazione di API nell'API target simulata.