Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Installa SageMaker AI Spaces Add-on
## Dipendenze
**Componente aggiuntivo Amazon EKS Pod Identity Agent **
+ Necessario per consentire all'operatore di ottenere le credenziali AWS
+ **In genere preinstallato ** sulla maggior parte dei cluster EKS
+ Installazione: tramite componenti aggiuntivi EKS
**Cert-manager**
+ Necessario per la gestione dei certificati TLS
+ **Pre-installed**se si utilizza la creazione HyperPod rapida del cluster
+ Installazione: tramite componenti aggiuntivi EKS
**Driver EBS CSI **
+ Necessario per l'archiviazione persistente nello spazio (volumi EBS)
+ **Installato automaticamente ** quando si utilizza la SageMaker console per l'installazione
+ Richiede un ruolo IAM con HyperPod-specific autorizzazioni `AmazonEBSCSIDriverPolicy` \+
+ Installazione: tramite componenti aggiuntivi EKS. Tuttavia, assicurati di seguire la guida per installare le autorizzazioni aggiuntive necessarie per. HyperPod
+ Riferimento: [ utilizzo del driver Amazon EBS CSI su HyperPod ](https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-hyperpod-eks-ebs.html)
## Dipendenze aggiuntive per WebUI Access
**AWS Load Balancer Controller **
+ **Pre-installed**se si utilizza la creazione HyperPod rapida del cluster
+ Installazione: Via Helm
+ Guida all'installazione manuale: [ installazione del AWS Load Balancer Controller ](https://docs.aws.amazon.com/eks/latest/userguide/lbc-helm.html)
**DNS esterno **
+ Richiesto quando si utilizza un dominio personalizzato per l'accesso WebUI
+ Gestisce automaticamente i record DNS di Route53
+ Richiede il ruolo IAM con autorizzazioni Route53
+ Installazione: tramite componenti aggiuntivi EKS
## Installazione
Prima di iniziare, assicurati di avere:
+ Un SageMaker HyperPod cluster attivo con almeno un nodo di lavoro che esegue Kubernetes versione 1.30 o successiva
+ Almeno un nodo di lavoro con tipo di istanza minimo (XX vCPU, YY GiB di memoria)
### Installazione del componente aggiuntivo Amazon Spaces SageMaker
Puoi installare il componente aggiuntivo SageMaker Spaces utilizzando l'installazione rapida per le impostazioni predefinite o l'installazione personalizzata per la configurazione avanzata.
#### Installazione rapida
1. Apri la SageMaker console Amazon all'indirizzo [ https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Scegli il tuo cluster dall'elenco dei cluster.
1. Nella scheda IDE e notebook, individua Amazon SageMaker Spaces, quindi scegli Installazione rapida.
Installazione rapida automatica:
+ Crea i ruoli IAM richiesti per il componente aggiuntivo
+ Abilita la modalità di accesso remoto con i ruoli IAM richiesti per Systems Manager
+ Installa il componente aggiuntivo e configura l'associazione delle identità dei pod
#### Installazione personalizzata
1. Apri la SageMaker console Amazon all'indirizzo [ https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. Scegli il tuo cluster dall'elenco dei cluster.
1. Nella scheda IDE e notebook, individua Amazon SageMaker Spaces, quindi scegli Installazione personalizzata.
1. Configura le opzioni seguenti:
**Ruoli IAM necessari per il componente aggiuntivo **
+ Scegli se creare nuovi ruoli IAM con le autorizzazioni consigliate o utilizzare quelli esistenti con le autorizzazioni richieste (consulta la sezione Configurazione delle autorizzazioni dell'amministratore sopra riportata)
**Configurazione dell'accesso remoto **
+ Abilita per consentire agli utenti di connettersi agli spazi dal codice di Visual Studio locale utilizzando AWS Systems Manager
+ Per il ruolo di istanza gestita da SSM:
+ **Crea nuovo ruolo**: il componente aggiuntivo crea e gestisce il ruolo con le autorizzazioni richieste da Systems Manager
+ **Usa il ruolo esistente**: seleziona un ruolo preconfigurato con le autorizzazioni di Systems Manager necessarie
+ Assicurati che il ruolo di Add-on esecuzione di Spaces disponga PassRole delle autorizzazioni per il ruolo di istanza gestita da SSM
**Nota**
L'abilitazione dell'accesso remoto attiva il livello di istanze avanzate AWS di Systems Manager con costi aggiuntivi per istanza. Per informazioni sui prezzi, consulta i prezzi di Systems Manager.
**Configurazione dell'accesso al browser Web **
+ Abilita per consentire agli utenti di accedere agli spazi tramite un browser Web utilizzando i certificati DNS e SSL Route 53
+ **Prerequisiti: ** installare AWS Load Balancer Controller prima di abilitare l'accesso al browser
+ **Zona ospitata Route 53: ** seleziona una zona ospitata esistente per un dominio o sottodominio di tua proprietà. Il dominio o sottodominio deve essere registrato e sotto il tuo controllo per abilitare la gestione DNS e la convalida del certificato SSL.
Per maggiori dettagli sulla registrazione del dominio, consulta [ Registrazione di un nuovo dominio ](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/domain-register.html#domain-register-procedure-section) nella Route 53 Developer Guide.
+ **Sottodominio: ** inserisci il prefisso del sottodominio (solo alfanumerico e trattini, massimo 63 caratteri)
+ **Certificato SSL: ** seleziona un certificato SSL esistente da Certificate Manager. AWS Il certificato deve essere valido e coprire sia il sottodominio (ad esempio, subdomain.domain.com) che i sottodomini wildcard (ad esempio, \*.subdomain.domain.com) per supportare i singoli URL di accesso allo spazio.
+ **Chiave ** di AWS firma del token: seleziona una chiave asimmetrica KMS per la firma del token JWT. La chiave viene utilizzata per crittografare i token di autenticazione per un accesso sicuro a WebUI. Puoi creare una nuova chiave asimmetrica in KMS o selezionarne una esistente a cui il tuo account abbia accesso.
**Nota**
Le tariffe standard di Route 53 si applicano alle zone ospitate e alle query DNS. Per informazioni sui prezzi, consulta i prezzi di Route 53.
#### Installazione del componente aggiuntivo EKS - Jupyter K8s con WebUI
##### File di configurazione
Crea: `addon-config.yaml`
```
jupyter-k8s:
workspacePodWatching:
enable: true
jupyter-k8s-aws-hyperpod:
clusterWebUI:
enabled: true
domain: ""
awsCertificateArn: ""
kmsEncryptionContext:
enabled: true
traefik:
shouldInstall: true
auth:
kmsKeyId: ""
```
**Sostituisci i seguenti segnaposto: **
+ : Il tuo nome di dominio (ad es.`jupyter.example.com`)
+ : Il tuo certificato ACM ARN (ad es. `arn:aws:acm:us-west-2:111122223333:certificate/12345678-1234-1234-1234-123456789012`
+ : L'ARN della tua chiave KMS (ad es. `arn:aws:kms:us-west-2:111122223333:key/12345678-1234-1234-1234-123456789012`
##### Installazione tramite AWS CLI
```
aws eks create-addon \
--cluster-name \
--addon-name amazon-sagemaker-spaces \
--configuration-values file://addon-config.yaml \
--resolve-conflicts OVERWRITE \
--region
```
**Per aggiornare l'addon esistente: **
```
aws eks update-addon \
--cluster-name \
--addon-name amazon-sagemaker-spaces \
--configuration-values file://addon-config.yaml \
--resolve-conflicts OVERWRITE \
--region
```
##### Installazione tramite Console di gestione AWS
1. Vai alla console ** EKS ** → Seleziona il tuo cluster
1. Fai clic ** Add-ons ** sulla scheda → ** Aggiungi nuovo **
1. Seleziona il componente ** aggiuntivo ** SageMaker Spaces
1. Incolla la configurazione YAML sopra riportata nelle impostazioni di configurazione opzionali ** **
1. Fai clic su ** Avanti**, quindi rivedi le impostazioni del componente aggiuntivo
1. Fai clic su Crea ** **
##### Verifica l'installazione
```
# Check addon status
aws eks describe-addon \
--cluster-name \
--addon-name amazon-sagemaker-spaces \
--region
```
##### Personalizzazione degli attributi ALB
Per impostazione predefinita, l'addon crea un load balancer pubblico da utilizzare con l'interfaccia utente web. È possibile personalizzare gli attributi del load balancer utilizzando le proprietà del componente aggiuntivo EKS.
Per creare un ALB interno, imposta lo schema su: `internal`
```
jupyter-k8s-aws-hyperpod:
clusterWebUI:
enabled: true
domain: ""
awsCertificateArn: ""
alb:
scheme: "internal" # Default is "internet-facing"
```
Puoi anche utilizzare il `alb.annotations` campo per personalizzare le impostazioni ALB:
```
jupyter-k8s-aws-hyperpod:
clusterWebUI:
enabled: true
domain: ""
awsCertificateArn: ""
alb:
scheme: "internal"
annotations:
alb.ingress.kubernetes.io/security-groups: ""
alb.ingress.kubernetes.io/subnets: ","
alb.ingress.kubernetes.io/load-balancer-attributes: "idle_timeout.timeout_seconds=60"
```
**Annotazioni ALB comuni: **
+ `alb.ingress.kubernetes.io/security-groups`: Specifica i gruppi di sicurezza per l'ALB
+ `alb.ingress.kubernetes.io/subnets`: Specifica le sottoreti per l'ALB
+ `alb.ingress.kubernetes.io/load-balancer-attributes`: imposta gli attributi ALB (timeout di inattività, registri di accesso, ecc.)
Consulta la documentazione [AWS del Load Balancer Controller ](https://kubernetes-sigs.github.io/aws-load-balancer-controller/latest/guide/ingress/annotations/) per tutte le annotazioni disponibili.
### Aggiornamento/controllo delle versioni del componente aggiuntivo
```
aws eks update-addon \
--cluster-name \
--addon-name amazon-sagemaker-spaces \
--configuration-values file://addon-config.yaml \
--resolve-conflicts OVERWRITE \
--region
```