Risoluzione dei problemi del servizio canonico in Anthos Service Mesh

Nota: i servizi canonici sono supportati automaticamente in Anthos Service Mesh 1.6.8 e versioni successive.

Questa sezione illustra i problemi comuni di Anthos Service Mesh e come risolverli. Se hai bisogno di ulteriore assistenza, vedi Ricevere assistenza.

I cluster nel tuo mesh stanno eseguendo una versione precedente di Anthos Service Mesh

Se uno dei tuoi cluster esegue una versione precedente di Anthos Service Mesh (<1.6.8) o un cluster esegue Anthos Service Mesh con il controller del servizio canonico disattivato, i cluster (e i servizi in esecuzione su di essi) non verranno visualizzati nella UI di Service Mesh. Per utilizzare i servizi canonici, devi eseguire l'upgrade di ogni cluster ad Anthos Service Mesh 1.6.8 o versioni successive e utilizzare l'opzione di installazione predefinita, che include il controller del servizio canonico. Per ulteriori informazioni, consulta Upgrade di Anthos Service Mesh alla versione più recente se i tuoi cluster sono su GKE o Upgrade di Anthos Service Mesh on-premise.

In alternativa, se preferisci non installare il controller nei tuoi cluster, puoi abilitare il controller del servizio canonico gestito (attualmente in anteprima) per il tuo mesh.

Per ulteriori informazioni sull'abilitazione del controller di servizio canonico, consulta Attivazione del controller di servizio canonico.

Anthos Service Mesh non è installato nel cluster

Se Anthos Service Mesh non è installato in nessuno dei tuoi cluster, questi non verranno visualizzati nella UI di Service Mesh. Per ulteriori informazioni su come installare Anthos Service Mesh, consulta la documentazione di Anthos Service Mesh.

Non hai eseguito l'accesso al cluster on-premise

Se disponi di un cluster on-premise nel mesh e non hai eseguito l'accesso al cluster, non potrai visualizzare i servizi corrispondenti al cluster. Per visualizzare questi servizi nella dashboard, devi accedere al cluster. Per maggiori informazioni sull'accesso a un cluster, consulta Accedere a un cluster dalla console Cloud.

Il tuo cluster on-premise non è raggiungibile

Se hai un cluster on-premise nel mesh e non è raggiungibile tramite l'agente di connessione, non potrai visualizzare i servizi corrispondenti al cluster. Per visualizzare questi servizi nella dashboard, assicurati che il cluster sia in esecuzione e connesso a Google Cloud. Per ulteriori informazioni sulla connessione del cluster a Google Cloud, consulta la panoramica di Connect.

Un servizio con SLO definiti non mappa 1:1 con un servizio canonico

Prima del passaggio al servizio canonico, Anthos Service Mesh mostrava le dashboard per i servizi Kubernetes. Sebbene i servizi Kubernetes e i servizi canonici predefiniti siano spesso allineati, è possibile che un servizio Kubernetes non possa essere abbinato automaticamente al servizio canonico corrispondente o che il confine del servizio canonico predefinito non sia desiderato.

Se hai configurato obiettivi del livello di servizio (SLO) su servizi esistenti che non possono essere abbinati automaticamente a un servizio canonico predefinito, non è possibile eseguirne la migrazione. Per iniziare a utilizzare i servizi canonici, devi eliminare gli SLO per il servizio problematico. Se vuoi, puoi creare nuovi SLO per i servizi canonici che corrispondono il più possibile a quel servizio prima di eliminare il precedente SLO.

Nella mia dashboard non sono disponibili i contenuti previsti

Le dashboard dei servizi Mesh di servizi hanno ciascun ambito a un servizio canonico nel tuo mesh di servizi, dove un servizio canonico è un concetto di servizio logico di alto livello che include tutti i carichi di lavoro, regioni e così via pertinenti.

Per impostazione predefinita, le etichette esistenti in ogni istanza di carico di lavoro (pod o WorkloadEntry) definiscono i servizi canonici e seguono queste regole in ordine decrescente:

L'etichetta service.istio.io/canonical-name è già stata impostata esplicitamente. Non verrà intrapresa alcuna altra azione.
In caso contrario, l'etichetta service.istio.io/canonical-name viene aggiunta e il suo valore viene impostato su quello dell'etichetta app.kubernetes.io/name.
In caso contrario, l'etichetta service.istio.io/canonical-name viene aggiunta e il suo valore viene impostato su quello dell'etichetta app.
In caso contrario, viene aggiunta l'etichetta service.istio.io/canonical-name e il suo valore viene impostato sul valore name del carico di lavoro proprietario. Il "carico di lavoro proprietario" in questo caso, se il deployment del pod viene eseguito da solo, oppure del deployment, StatefulSet e così via, se si utilizza un'orchestrazione di livello superiore.

Per la maggior parte degli utenti idiomatici di Kubernetes e Kube Run / Knative, queste regole sono mappate direttamente al modo in cui gestisci già servizi e carichi di lavoro.

In alcuni casi d'uso più personalizzati o più complessi, tuttavia, l'euristica predefinita non acquisisce il servizio in modo appropriato e, a sua volta, la dashboard di Anthos Service Mesh che vedi non include i contenuti previsti.

Puoi risolvere il problema definendo manualmente l'ambito del servizio canonico.

Definire manualmente l'ambito di un servizio

Se possibile, ti consigliamo di utilizzare i meccanismi di raggruppamento predefiniti automatici. Tuttavia, se vuoi eseguire l'override di questi raggruppamenti predefiniti, puoi applicare l'etichetta Kubernetes service.istio.io/canonical-name alle configurazioni del pod Kubernetes e di WorkloadEntry.

Per maggiori dettagli, consulta la sezione sulla definizione manuale di un servizio canonico.