Gestione dei componenti del piano di runtime

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

Informazioni sul file degli override

La prima volta che installi il runtime ibrido in un cluster, devi Crea un file di configurazione che sostituisce il file. Questo file ti consente di fornire i valori delle proprietà obbligatori necessari per installare il modello ibrido, ad esempio nome del progetto Google, nome dell'organizzazione e ambiente dettagli, file di certificati e così via. Puoi anche sostituire alcuni valori predefiniti per la maggior parte i componenti ibridi nel file degli override. Per un Elenco delle proprietà configurabili, consulta la sezione Informazioni di riferimento sulle proprietà di configurazione.

La procedura di installazione ibrida illustra la procedura di creazione un file di override e di applicare la configurazione a un cluster. Se vuoi modificare la configurazione in un secondo momento, modifica il file degli override creato e applicarlo di nuovo. Consulta la sezione Apportare una modifica alla configurazione.

Apportare una modifica alla configurazione

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

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

  1. Apri il file degli override. Assicurati di utilizzare lo stesso file di override che è stato utilizzato per installare il runtime ibrido nel cluster.
  2. Individua l'elemento logger nel file. Ad esempio: 
    ...
logger:
  enabled: false
...
  3. Modifica 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 definizione dell'ambito, come --telemetry, consulta Ambiti per l'applicazione di apigeectl.

Quali proprietà di configurazione puoi modificare?

Puoi trovare l'elenco completo delle proprietà configurabili nella sezione Informazioni di riferimento sulle proprietà di configurazione. Il riferimento elenca solo le proprietà che puoi modificare; se tenti di modificare una proprietà che non è riferimento, la modifica viene ignorata.

Come utilizzare il riferimento alla configurazione

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

authz.image.pullPolicy

Nel file degli override, le proprietà sono formattate nel formato YAML corretto. Per l'esempio precedente, l'elemento authz di primo livello è rientrato a sinistra e le proprietà dell'elemento secondario sono rientrate sotto di esso. Inoltre, YAML richiede i due punti la fine di ogni elemento e sottoelemento.

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

authz:
  image:
    pullPolicy: Always

Per un altro esempio, la proprietà cassandra.auth.admin.password (così come è elencato in Riferimento proprietà di configurazione) viene utilizzato per impostare la proprietà di Cassandra password di amministratore. Per modificarlo, individua il seguente YAML nel file degli override e imposta come segue:

cassandra:
  auth:
    admin:
      password: abc123

Ricorda che il Riferimento proprietà di configurazione descrive tutte le proprietà che puoi impostare. sui componenti del piano di runtime ibrido. Segui lo schema spiegato in precedenza per modificare questi elementi nel file degli override prima di applicare le modifiche al cluster.

Informazioni sulle impostazioni predefinite di configurazione

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

I file di override seguono lo stesso codice YAML struttura come values.yaml; mentre un file di override include solo un sottoinsieme delle proprietà di configurazione values.yaml. Ricorda: non tutte le proprietà sono modificabili. Quando applichi una configurazione a un cluster, gli override vengono uniti ai valori predefiniti per creare l'ambiente Kubernetes completo e la configurazione del cluster.

Utilizzare i file di override predefiniti di esempio

Apigee fornisce un set di file di esempio per gli override ti guideranno nella configurazione del deployment ibrido. È una buona pratica per copiare e modificare il file degli override che più si avvicina ai requisiti di installazione.

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

File di esempio con override Descrizione
overrides-small.yaml Questo esempio è ideale per iniziare rapidamente. Utilizza l'impronta minima consigliata per avviare i componenti di runtime ibridi. Questa configurazione di esempio si basa su il più possibile sulle impostazioni e sui valori predefiniti. Tutte le repliche minime sono impostate su 1.
overrides-medium.yaml Questo esempio è un buon punto di partenza per gli ambienti di test e QA. Singoli componenti dispone di un livello più elevato di risorse per gestire traffico aggiuntivo. Cassandra utilizza dischi SSD per migliorare le prestazioni. In questo ambiente, è consigliabile che gli utenti installino stateful e stateless su nodi separati. Vedi Configura nodi dedicati.
overrides-large.yaml Questo esempio è un buon punto di partenza per ambienti ad alte prestazioni come pre-produzione e produzione. L'esempio include le proprietà per l'impostazione 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 private.

Annotazioni personalizzate

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

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

runtime:
  annotations:
    businessunit: "bu1"

Usa dry run per testare le modifiche alla configurazione

Puoi utilizzare il flag --dry-run con apigeectl per testare esegue l'override del file di configurazione senza applicarlo effettivamente al cluster. Questa opzione è utile per il debug di un problema di installazione perché ti 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 seguente comando:

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, ognuno dei quali pubblica uno specifico requisito. Ad esempio, potresti avere un file di override che ottimizza il cluster per produzione e un altro per creare un cluster per i test. Puoi quindi mantenere nel tuo sistema di controllo dei file sorgente.

Utilizza il comando apigeectl apply per applicare gli override nel cluster. Ad esempio:

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

Elimina i componenti di runtime

Il comando apigeectl delete fornisce i flag che consentono elimini 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 runtime (locale) sia la gestione (cloud) aerei. Per maggiori dettagli, vedi Eliminare gli ambienti.