Eseguire l'onboarding di un'organizzazione

Edge per Private Cloud v. 4.16.05

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

Nell'ambito del processo di inserimento, lo script:

Facoltativamente, crea un nuovo utente che fungerà da amministratore dell'organizzazione.

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

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 invisibile:

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

L'unico requisito per le installazioni automatiche è che il file di configurazione deve essere accessibile o leggibile da "apigee" utente. Ad esempio, inserisci il file nella directory /tmp sul node.

Di seguito è riportato un esempio di file di configurazione silenzioso. Modificalo in base alle tue esigenze requisiti:

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 disponi già di un record DNS che utilizzerai per accedere all'host virtuale, specifica l'host e facoltativamente la porta, ad esempio "myapi.example.com".

    Se non disponi ancora di un record DNS, vedi Configurazione di un host virtuale per ulteriori informazioni.
  • Per la configurazione TLS/SSL, consulta archivi e chiavi Archivi attendibili e Configurazione di TLS/SSL per Edge on-premise per ulteriori informazioni sulla creazione del file JAR e su altri aspetti della per configurare TLS/SSL.

Onboarding

  1. Installa apigee-provision su il 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, metti il file nella directory /tmp del nodo.

Verifica delle operazioni preliminari

Al termine dell'onboarding, verifica lo stato del sistema inviando il seguente CURL sul nodo server di gestione.

  1. Verifica lo stato degli utenti e dell'organizzazione sul server di gestione inviando quanto segue Comandi CURL:
    &gt; curl -u <adminEmail>:<passwd amministratore> http://localhost:8080/v1/users
    &gt; curl -u <adminEmail>:<passwd amministratore> http://localhost:8080/v1/organizations
    &gt; curl -u <adminEmail>:<passwd amministratore> http://localhost:8080/v1/organizations/&lt;orgname&gt;/deployments
  2. Se hai abilitato l'analisi, utilizza questo comando:
    &gt; curl -u <adminEmail>:<passwd amministratore> http://localhost:8080/v1/organizations/&lt;orgname&gt;/environments/&lt;envname&gt;/provisioning/axstatus
  3. Puoi anche controllare lo stato del database PostgreSQL eseguendo il seguente comando sulla macchina 2 per avviare psql:
    > psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

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

    Utilizza il seguente comando per uscire da psql:
    apigee=# \q
  4. Accedi all'interfaccia utente di Apigee Edge utilizzando un browser web. Ricorda che hai già fatto l'URL 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 è della Macchina 1 o di qualsiasi macchina che hai installato attiva l'UI per le configurazioni alternative:
      http://192.168.56.111:9000/login

      9000 è il numero di porta utilizzato dalla UI. Se avvii il browser direttamente sulla 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 dell'amministratore di sistema globale che hai impostato durante l'installazione. In alternativa, puoi:
  5. Registrati per creare un nuovo account utente Apigee e utilizza le credenziali del nuovo utente per accedere.
    1. Fai clic su Accedi. Il browser ti reindirizza a:
      http://192.168.56.111:9000/platform/#/<nomeorganizzazione>/

      e apre una dashboard che consente di configurare l'organizzazione creata in precedenza (se ha 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 ulteriori informazioni, consulta Creare il tuo primo proxy API.