Risolvi i problemi relativi ai cluster Amazon locali su EKS AWS Outposts

I cluster locali vengono creati tramite Amazon EKSAPI, ma vengono eseguiti in modo asincrono. Ciò significa che le richieste ad Amazon vengono EKS API restituite immediatamente per i cluster locali. Tuttavia, queste richieste potrebbero avere esito positivo, anticipare l’errore a causa di errori di convalida degli input oppure fallire e riportare errori di convalida descrittivi. Questo comportamento è simile al Kubernetes API.

I cluster locali non effettuano la transizione a uno stato FAILED. Amazon EKS tenta di riconciliare lo stato del cluster con lo stato desiderato richiesto dall'utente in modo continuo. Di conseguenza, un cluster locale può rimanere a lungo nello stato CREATING, fino a quando il problema di base non viene risolto.

I problemi relativi ai cluster locali possono essere scoperti utilizzando il EKS AWS CLI comando describe-clusterAmazon. I problemi relativi ai cluster locali vengono evidenziati dal campo cluster.health della risposta del comando describe-cluster. Il messaggio contenuto in questo campo include un codice di errore, un messaggio descrittivo e una risorsa IDs correlata. Queste informazioni sono disponibili AWS CLI solo tramite Amazon EKSAPI. Nell'esempio seguente, sostituisci my-cluster con il nome del cluster locale.

aws eks describe-cluster --name my-cluster --query 'cluster.health'

Di seguito viene riportato un output di esempio:

{
    "issues": [
        {
            "code": "ConfigurationConflict",
            "message": "The instance type 'm5.large' is not supported in Outpost 'my-outpost-arn'.",
            "resourceIds": [
                "my-cluster-arn"
            ]
        }
    ]
}

Se il problema non è risolvibile, potrebbe essere necessario eliminare il cluster locale e crearne uno nuovo. Ad esempio, ciò potrebbe verificarsi nel caso in cui si provi ad allocare un cluster con un tipo di istanza che non è disponibile sul tuo Outpost. La tabella seguente include gli errori più comuni relativi allo stato di integrità.

La tabella seguente elenca gli errori Servizi AWS di altri utenti presentati nel campo relativo allo stato della describe-cluster risposta.

I cluster locali richiedono autorizzazioni e politiche diverse rispetto EKS ai cluster Amazon ospitati nel cloud. Quando un cluster non riesce a creare e produce un InvalidPermissions errore, ricontrolla che al ruolo del cluster che stai utilizzando sia associata la politica mazonEKSLocal OutpostClusterPolicy gestita A. Tutte le altre API chiamate richiedono lo stesso set di autorizzazioni dei EKS cluster Amazon nel cloud.

La quantità di tempo necessaria per creare un cluster locale varia a seconda di diversi fattori. Questi fattori includono la configurazione della rete, la configurazione dell'Outpost e la configurazione del cluster. In generale, viene creato un cluster locale che passa allo stato ACTIVE entro 15-20 minuti. Se un cluster locale rimane nello stato CREATING, puoi richiamare describe-cluster per informazioni sulla causa nel campo di output cluster.health.

I problemi più comuni sono i seguenti:

VPCe la configurazione della sottorete è DNS configurata in modo errato o mancante

Verificare Crea sottoreti VPC e sottoreti per i cluster Amazon su EKS AWS Outposts.

Quando un Outpost viene disconnesso da Regione AWS quello a cui è associato, Kubernetes il cluster probabilmente continuerà a funzionare normalmente. Tuttavia, se il cluster non funziona correttamente, segui la procedura di risoluzione dei problemi riportata in Prepara EKS i cluster Amazon locali AWS Outposts per le disconnessioni di rete. Se riscontri altri problemi, contatta AWS Support. AWS Support può guidarti nel download e nell'esecuzione di uno strumento di raccolta dei log. In questo modo, puoi raccogliere i log dal tuo Kubernetes raggruppa le istanze del piano di controllo e inviale al AWS Support supporto per ulteriori indagini.

Quando le istanze del piano di EKS controllo di Amazon non sono raggiungibili tramite AWS Systems Manager (Systems Manager), Amazon EKS visualizza il seguente errore per il tuo cluster.

Amazon EKS control plane instances are not reachable through SSM. Please verify your SSM and network configuration, and reference the EKS on Outposts troubleshooting documentation.

Per risolvere questo problema, assicurati che le tue sottoreti VPC e le tue sottoreti soddisfino i requisiti Crea sottoreti VPC e sottoreti per i cluster Amazon su EKS AWS Outposts e di aver completato i passaggi descritti nella Configurazione di Session Manager nella Guida per l'utente. AWS Systems Manager