Questa pagina è stata tradotta dall'API Cloud Translation.

Gestione dei componenti del piano di runtime

Questo argomento spiega come configurare e gestire i componenti del piano di runtime di Apigee hybrid. Per un elenco dei per componenti del piano di runtime che puoi configurare, consulta Servizio di runtime panoramica della configurazione.

Informazioni sul file delle sostituzioni

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 ignorare i valori di configurazione predefiniti come necessario, configurare gli ambienti, fare riferimento ai certificati TLS e alle chiavi dell'account servizio, assegnare i pool di nodi Kubernetes a componenti ibridi specifici e così via.

I passaggi di installazione dell'architettura ibrida illustrano la procedura di creazione di un file di override e di applicazione della configurazione a un cluster. Se vuoi modificare la configurazione in un secondo momento, modifica il file degli override creato e applicarlo di nuovo.

Apportare una modifica alla configurazione

Per apportare una modifica alla configurazione di un componente del piano di runtime ibrido, modificare il file di override applica le modifiche con apigeectl.

Ad esempio, per modificare il conteggio delle repliche Processore di messaggi, segui questi passaggi:

Apri il file YAML delle sostituzioni. Assicurati di utilizzare lo stesso file di override utilizzato per l'installazione il runtime ibrido nel cluster.

Individua l'elemento runtime nel file. Ad esempio:

...
runtime:
  nodeSelector:
    key: cloud.google.com/gke-nodepool
    value: apigee-runtime
  replicaCountMin: 1
  replicaCountMax: 2
...

Modifica le proprietà del conteggio delle repliche in base alle tue esigenze. Ad esempio:

...
runtime:
  nodeSelector:
    key: cloud.google.com/gke-nodepool
    value: apigee-runtime
  replicaCountMin: 2
  replicaCountMax: 4
...

Utilizza apigeectl per applicare la modifica al cluster:
```
apigeectl apply -f ./my_overrides.yaml -c runtime
```
Usa l'opzione -c quando vuoi limitare il cluster vengono aggiornati a un componente. Se ometti il flag -c, apigeectl applica tutte le modifiche che trova nel file delle sostituzioni. Se è quello che vuoi, ometti il -c flag al momento dell'applicazione. In caso contrario, utilizza -c per specificare un componente. per aggiornarli. Vedi anche Applica la configurazione a un singolo componente.

Quali proprietà di configurazione puoi modificare?

Puoi trovare l'elenco completo delle proprietà configurabili nel riferimento per le proprietà di configurazione. Il riferimento elenca solo le proprietà che puoi modificare. Se provi a modificare una proprietà non presente nel 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. Nell'esempio riportato sopra, l'elemento authz di primo livello è rientrato a sinistra e le proprietà degli elementi secondari sono rientrate sotto. Inoltre, YAML richiede i due punti alla fine di ogni elemento e sottoelemento.

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

authz:
  image:
    pullPolicy: Always

Per un altro esempio, la proprietà cassandra.auth.admin.password (così come è elencato nel riferimento della proprietà Configurazione) viene utilizzato per impostare la proprietà password di amministratore. Per modificarlo, individua il seguente codice YAML nel file delle sostituzioni e impostalo:

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.

Utilizzo di file di override di esempi predefiniti

Quando installi per la prima volta il runtime ibrido, Apigee consiglia di utilizzare uno dei l'esempio preconfigurato sostituisce i file. Questi esempi forniscono un insieme completo di proprietà di configurazione per scenari di installazione specifici, ad esempio per la configurazione di un'installazione di produzione o di test. Devi solo fornire valori appropriati per le proprietà e applicare il file delle sostituzioni al cluster. Per ulteriori informazioni, consulta Creare un file di override.

Informazioni sui valori predefiniti della configurazione

Apigee gestisce la configurazione predefinita dei componenti nel file hybrid_root_dir/config/values.yaml. I file di override seguono lo stesso YAML struttura: values.yaml.

Un file di override in genere include solo un sottoinsieme delle proprietà di configurazione presenti in 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 la configurazione del cluster. Consulta anche Eseguire l'output della configurazione unita.

Il codice seguente mostra la configurazione predefinita per il componente mart come trovato in values.yaml. Nota alcuni valori hanno valori predefiniti, mentre altri, come sslCertPath e sslKeyPath no. Devi fornire questi valori mancanti nel file delle sostituzioni, come spiegato nella procedura di installazione. Se vuoi modificare uno dei valori predefiniti, assicurati che siano modificabili controllandoli nel riferimento alla proprietà di configurazione.

...
mart:
  replicaCountMin: 2
  replicaCountMax: 4
  targetCPUUtilizationPercentage: 75
  terminationGracePeriodSeconds: 30
  sslCertPath:
  sslKeyPath:
  hostAlias:
  nodeSelector:
    key:
    value:
  revision: blue
  image:
    url: "google/apigee-mart-server"
    tag: "1.0.0"
    pullPolicy: IfNotPresent
  resources:
    requests:
      cpu: 500m
      memory: 512Mi
  initCheckCF:
    resources:
      requests:
        cpu: 10m
  livenessProbe:
    timeoutSeconds: 1
    failureThreshold: 12
    periodSeconds: 5
    initialDelaySeconds: 15
  readinessProbe:
    timeoutSeconds: 1
    successThreshold: 1
    failureThreshold: 2
    periodSeconds: 5
    initialDelaySeconds: 15
  metricsURL: "/v1/server/metrics"
  cwcAppend: |
...

Per modificare le impostazioni predefinite di un componente che viene non è già presente nel file degli override, puoi copiare il relativo YAML da values.yaml nel tuo esegue l'override del file e lo modifica lì.

Non modificare mai values.yaml direttamente; utilizza sempre un file di override per specificare le proprietà di configurazione.

Esempi di file con override

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 nella directory hybrid_root_dir/examples:

File di override di esempio	Descrizione
`overrides-small.yaml`	Questo esempio è ideale per iniziare rapidamente. Utilizza l'impronta minima consigliata per avviare i componenti runtime ibrida. Questa configurazione di esempio si basa il più possibile su impostazioni e 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 il traffico aggiuntivo. Cassandra utilizza dischi SSD per migliorare le prestazioni. In questo ambiente, è consigliabile che gli utenti installino stateful e stateless su nodi separati. Consulta Configurare i 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.

Stampa la configurazione unita

Puoi utilizzare il flag --dry-run con apigeectl per generare l'unione di configurazione senza applicarlo effettivamente al cluster. Questa opzione è utile per il debug di un problema di installazione perché mostra esattamente cosa verrà applicato al cluster. È inoltre buona norma generare l'output della configurazione e archiviarla nel controllo dei file sorgente in modo da avere un riferimento delle risorse installate e configurate nel cluster.

Ad esempio:

apigeectl apply -f ./my_overrides.yaml --dry-run --print-yaml > apigee-hybrid.yaml

Per ulteriori informazioni, vedi apigeectl.

Crea più file di override in base alle esigenze

Puoi creare tutti i file di override che vuoi, ognuno dei quali soddisfa un requisito specifico. Ad esempio, potresti avere un file di override che ottimizza il cluster per la produzione e un altro per la creazione di un cluster di test. Puoi quindi mantenere nel tuo sistema di controllo dei file sorgente.

Utilizza l'opzione -f con apigeectl per specificare la località e il nome di un file di override. Ad esempio:

apigeectl apply  -f ./test_env_override.yaml

Per ulteriori informazioni, vedi apigeectl.

Eliminare i componenti del piano di runtime specifici di hybrid

Per eliminare i componenti del piano di runtime specifici per l'infrastruttura ibrida dal cluster, utilizza il comando apigeectl delete. Questi componenti includono synchronizer, mart, runtime, cassandra e udca. Assicurati di specificare lo stesso file delle sostituzioni utilizzato per installare i componenti di runtime:

Ad esempio:

apigeectl delete -f ./my_overrides.yaml

Puoi utilizzare il comando apigeectl apply per ricreare uno o più componenti specifici:

apigeectl apply -c synchronizer -f ./my_overrides.yaml

Per ulteriori informazioni, vedi apigeectl.

Eliminare un componente specifico

Se vuoi eliminare solo un componente specifico, utilizza la Opzione -c con apigeectl delete Assicurati di specificare lo stesso file di override che hai utilizzato per installare i componenti di runtime.

Ad esempio, per eliminare il componente Synchronizer, utilizza questo comando:

apigeectl delete -c synchronizer -f ./my_overrides.yaml

Puoi quindi utilizzare il comando apigeectl apply per ricreare il componente:

apigeectl apply -c synchronizer -f ./my_overrides.yaml

Per ulteriori informazioni, vedi apigeectl.

Eliminare tutti i componenti

Per eliminare tutti i componenti ibrida del cluster, inclusi quelli creati dal comando apigeectl init, utilizza il comando apigeectl delete con il flag --all. Assicurati che per specificare lo stesso file di override utilizzato per installare i componenti di runtime:

Ad esempio:

apigeectl delete -f ./my_overrides.yaml --all

Per ulteriori informazioni, vedi apigeectl.