Gestione dei componenti del piano di runtime

Questo argomento spiega come configurare e gestire i componenti del piano di runtime ibrido Apigee.

Informazioni sul file di override

La prima volta che installi il runtime ibrido in un cluster, devi creare un file di override di configurazione. Questo file consente di fornire i valori delle proprietà obbligatori per l'installazione di ambienti ibridi, come il nome del progetto Google, il nome dell'organizzazione, i dettagli dell'ambiente, i file dei certificati e così via. Puoi anche eseguire l'override di determinati valori predefiniti per la maggior parte dei componenti ibridi nel file di override. Per un elenco completo delle proprietà configurabili, consulta il riferimento sulle proprietà di configurazione.

La procedura di installazione di un modello ibrido illustra il processo di creazione di un file di override e di applicazione della configurazione a un cluster. Se vuoi cambiare la configurazione in un secondo momento, modifica il file di override che hai creato e applicalo di nuovo. Vedi Apportare una modifica alla configurazione.

Apportare una modifica alla configurazione

Per apportare una modifica alla configurazione di un componente del piano di runtime ibrido, modifica il file di override e applica le modifiche con apigeectl. Per un elenco completo delle proprietà configurabili, consulta il riferimento sulle proprietà di configurazione.

Ad esempio, per attivare il componente logger, aggiorna il file di override e applicalo di nuovo:

  1. Apri il file di override. Assicurati di utilizzare lo stesso file di override utilizzato per installare il runtime ibrido nel cluster.
  2. Individua l'elemento logger nel file. Ad esempio: 
    ...
logger:
  enabled: false
...
  3. Cambia il valore della proprietà in true: 
    ...
  logger:
  enabled: true
...
  4. Utilizza apigeectl per applicare la modifica al cluster: 
    $APIGEECTL_HOME/apigeectl apply -f $HYBRID_FILES/overrides/OVERRIDES.yaml --telemetry

    Il flag --telemetry indica a apigeectl di aggiornare solo il componente logger. Per informazioni sui parametri di ambito, come --telemetry, consulta Ambiti per l'applicazione di apigeectl.

Quali proprietà di configurazione puoi modificare?

Puoi trovare l'elenco completo delle proprietà configurabili nel riferimento delle proprietà di configurazione. Il riferimento elenca solo le proprietà che puoi modificare; se provi a modificare una proprietà che non è presente nel riferimento, la modifica viene ignorata.

Come utilizzare il riferimento alla configurazione

Il riferimento alle proprietà di configurazione utilizza la notazione dei punti per descrivere gli elementi di configurazione, dove il primo elemento è il nome dell'elemento di primo livello seguito da proprietà e proprietà secondarie. Ad esempio:

authz.image.pullPolicy

Nel file di override, le proprietà sono formattate in YAML appropriato. Nell'esempio precedente, l'elemento authz di primo livello è rientrato a sinistra e le proprietà dei sottoelementi sono rientrate al di sotto. Inoltre, YAML richiede due punti alla fine di ogni elemento e elemento secondario.

Ad esempio, per impostare la proprietà authz.image.pullPolicy su Always, individua questa stanza YAML nel file di override e impostala come segue:

authz:
  image:
    pullPolicy: Always

Per un altro esempio, la proprietà cassandra.auth.admin.password (indicata in Riferimento proprietà di configurazione) viene utilizzata per impostare la password di amministratore di Cassandra. Per modificarlo, individua il seguente YAML nel file di override e impostalo come segue:

cassandra:
  auth:
    admin:
      password: abc123

Ricorda, il riferimento alle proprietà di configurazione descrive tutte le proprietà che puoi impostare sui componenti del piano di runtime ibrido. Segui il pattern descritto sopra per modificare questi elementi nel file di override prima di applicare le modifiche al cluster.

Informazioni sulle impostazioni predefinite della configurazione

Apigee mantiene la configurazione predefinita dei componenti nel file $HYBRID_FILES/config/values.yaml. Questo file specifica i valori predefiniti, quando possibile, per ogni componente ibrido.

I file di override seguono la stessa struttura YAML di values.yaml; tuttavia, un file di override include solo un sottoinsieme delle proprietà di configurazione trovate in values.yaml. Tieni presente che non tutte le proprietà sono modificabili. Quando applichi una configurazione a un cluster, gli override vengono uniti ai valori predefiniti per creare la configurazione completa del cluster Kubernetes.

Utilizzo dei file di override di esempio predefiniti

Apigee fornisce un set di file di override di esempio per guidarti nella configurazione del deployment ibrido. È buona norma copiare e modificare il file di override che corrisponde meglio ai requisiti di installazione.

I seguenti esempi sono inclusi nella directory $APIGEECTL_HOME/examples:

File di override di esempio Descrizione
overrides-small.yaml Questo esempio è ideale per iniziare rapidamente. Utilizza l'ingombro minimo consigliato per avviare i componenti di runtime ibridi. Questa configurazione di esempio si basa il più possibile su impostazioni e valori predefiniti. Il numero minimo di repliche è impostato su 1.
overrides-medium.yaml Questo esempio è un buon punto di partenza per gli ambienti di test e QA. Ai singoli componenti è stato concesso un livello più elevato di risorse per gestire il traffico aggiuntivo. Cassandra utilizza dischi SSD per le prestazioni. In questo ambiente, è consigliabile che gli utenti installino componenti stateful e stateless su nodi separati. Vedi Configurare nodi dedicati.
overrides-large.yaml Questo esempio è un buon punto di partenza per ambienti ad alte prestazioni, come la pre-produzione e la produzione. L'esempio include proprietà per l'impostazione di chiavi di crittografia, password e altro. I singoli componenti hanno un minimo di due repliche.
private-overrides.yaml Questo esempio illustra come utilizzare le immagini da un repository di immagini privato. Vedi Utilizzare un repository di immagini privato.

Annotazioni personalizzate

Le annotazioni sono mappe chiave/valore utilizzate per collegare metadati ai pod Kubernetes. Puoi creare annotazioni personalizzate per le seguenti proprietà dei componenti ibridi elencate nel riferimento delle proprietà di configurazione:

Per aggiungere un'annotazione personalizzata di coppia nome/valore, apri il file di override e aggiungi una stanza annotations per il rispettivo componente, quindi applica la modifica con apigeectl. Ad esempio:

runtime:
  annotations:
    businessunit: "bu1"

Utilizza le prove per testare le modifiche alla configurazione

Puoi utilizzare il flag --dry-run con apigeectl per testare il file di configurazione degli override senza applicarlo effettivamente al tuo cluster. Questa opzione è utile per il debug di un problema di installazione perché mostra esattamente cosa verrà applicato al cluster.

In Apigee hybrid, la sintassi del flag --dry-run dipende dalla versione di kubectl in esecuzione. Controlla la versione di kubectl con il comando seguente:

kubectl version

kubectl 1.17 e versioni precedenti:

$APIGEECTL_HOME/apigeectl init -f $HYBRID_FILES/overrides/OVERRIDES.yaml --dry-run=true

kubectl 1.18 e versioni successive:

  $APIGEECTL_HOME/apigeectl init -f $HYBRID_FILES/overrides/OVERRIDES.yaml --dry-run=client

Crea più file di override in base alle esigenze

Puoi creare più file di override, in cui ciascuno soddisfa un requisito specifico. Ad esempio, potresti avere un file di override che ottimizza il cluster per la produzione e un altro per creare un cluster a scopo di test. Potrai quindi gestire questi file nel tuo sistema di controllo del codice sorgente.

Utilizza il comando apigeectl apply per applicare un file di override al cluster. Ad esempio:

$APIGEECTL_HOME/apigeectl apply  -f $HYBRID_FILES/overrides/test_env_override.yaml

Elimina componenti di runtime

Il comando apigeectl delete fornisce flag che consentono di eliminare tutti o un sottoinsieme dei componenti di runtime ibridi installati. Per maggiori dettagli, sull'utilizzo dei comandi, consulta la pagina di riferimento apigeectl. Vedi anche Disinstallare il runtime ibrido.

Eliminazione di un ambiente

Per eliminare completamente un ambiente, devi rimuovere sia il piano di runtime (locale) sia quello di gestione (cloud). Per maggiori dettagli, vedi Eliminare gli ambienti.