

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à.

# Crea un'istanza del notebook Braket usando CloudFormation
<a name="braket-cloudformation"></a>

**Suggerimento**  
**Impara le basi dell'informatica quantistica con\! AWS** Iscriviti all'[Amazon Braket Digital Learning](https://skillbuilder.aws/learning-plan/EH35DWGU3R/amazon-braket--knowledge-badge-readiness-path-includes-labs) Plan e ottieni il tuo badge digitale dopo aver completato una serie di corsi di apprendimento e una valutazione digitale.

Puoi utilizzarle CloudFormation per gestire le istanze dei tuoi notebook Amazon Braket. Le istanze per notebook Braket sono basate su Amazon SageMaker AI. Con CloudFormation, puoi fornire a un'istanza notebook un file modello che descrive la configurazione desiderata. Il file modello è scritto in formato JSON o YAML. È possibile creare, aggiornare ed eliminare le istanze in modo ordinato e ripetibile. Potresti trovarlo utile quando gestisci più istanze di Braket Notebook nel tuo. Account AWS

Dopo aver creato un CloudFormation modello per un notebook Braket, lo usi CloudFormation per distribuire la risorsa. *Per ulteriori informazioni, consulta [Creazione di uno stack sulla CloudFormation console nella guida](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) per l'CloudFormation utente.*

Per creare un'istanza di Braket Notebook utilizzando CloudFormation, esegui questi tre passaggi:

1. Crea uno script di SageMaker configurazione del ciclo di vita AI.

1. Crea un ruolo AWS Identity and Access Management (IAM) che venga assunto dall' SageMaker IA.

1. Crea un'istanza di notebook SageMaker AI con il prefisso **amazon-braket-**

Puoi riutilizzare la configurazione del ciclo di vita per tutti i notebook Braket che crei. Puoi anche riutilizzare il ruolo IAM per i notebook Braket a cui assegni le stesse autorizzazioni di esecuzione.

**Topics**
+ [Fase 1: Creare uno script di configurazione del ciclo di vita AI SageMaker](#braket-create-cloudformation-template-step-1)
+ [Fase 2: creare il ruolo IAM assunto da Amazon SageMaker AI](#braket-create-cloudformation-template-step-2)
+ [Passaggio 3: creare un'istanza di notebook SageMaker AI con il prefisso `amazon-braket-`](#braket-create-cloudformation-template-step-3)

## Fase 1: Creare uno script di configurazione del ciclo di vita AI SageMaker
<a name="braket-create-cloudformation-template-step-1"></a>

Utilizza il seguente modello per creare uno script di configurazione del [ciclo di vita SageMaker AI](https://docs.aws.amazon.com/sagemaker/latest/dg/notebook-lifecycle-config.html). Lo script personalizza un'istanza di notebook SageMaker AI per Braket. *Per le opzioni di configurazione per la CloudFormation risorsa del ciclo di vita, consulta [AWS::SageMaker::NotebookInstanceLifecycleConfig](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sagemaker-notebookinstancelifecycleconfig.html)la guida per l'utente.CloudFormation * 

```
BraketNotebookInstanceLifecycleConfig:
    Type: "AWS::SageMaker::NotebookInstanceLifecycleConfig"
    Properties:
      NotebookInstanceLifecycleConfigName: BraketLifecycleConfig-${AWS::StackName}
      OnStart:
      - Content:
          Fn::Base64: |
            #!/usr/bin/env bash
            sudo -u ec2-user -i ≪EOS
            curl -o braket-notebook-lcc.zip https://d3ded4lzb1lnme.cloudfront.net/notebook/braket-notebook-lcc.zip
            unzip braket-notebook-lcc.zip
            ./install.sh
            EOS
            
            exit 0
```

## Fase 2: creare il ruolo IAM assunto da Amazon SageMaker AI
<a name="braket-create-cloudformation-template-step-2"></a>

Quando utilizzi un'istanza Braket Notebook, l' SageMaker IA esegue operazioni per tuo conto. Ad esempio, supponiamo di utilizzare un notebook Braket utilizzando un circuito su un dispositivo supportato. All'interno dell'istanza del notebook, l' SageMaker intelligenza artificiale esegue l'operazione su Braket per te. Il ruolo di esecuzione del notebook definisce le operazioni esatte che l' SageMaker IA è autorizzata a eseguire per tuo conto. Per ulteriori informazioni, consulta [i ruoli SageMaker AI](https://docs.aws.amazon.com/sagemaker/latest/dg/sagemaker-roles.html) nella *guida per sviluppatori di Amazon SageMaker AI*.

Usa l'esempio seguente per creare un ruolo di esecuzione del notebook Braket con le autorizzazioni richieste. È possibile modificare le politiche in base alle proprie esigenze.

**Nota**  
Assicurati che il ruolo abbia l'autorizzazione per i bucket `s3:ListBucket` e le `s3:GetObject` operazioni su Amazon S3 con il prefisso. `braketnotebookcdk-"` Lo script di configurazione del ciclo di vita richiede queste autorizzazioni per copiare lo script di installazione del notebook Braket.

```
ExecutionRole: 
    Type: "AWS::IAM::Role"
    Properties: 
      RoleName: !Sub AmazonBraketNotebookRole-${AWS::StackName}
      AssumeRolePolicyDocument: 
        Version: "2012-10-17"
        Statement: 
        - 
          Effect: "Allow"
          Principal: 
            Service: 
              - "sagemaker.amazonaws.com"
          Action: 
          - "sts:AssumeRole"
      Path: "/service-role/"
      ManagedPolicyArns:
        - arn:aws:iam::aws:policy/AmazonBraketFullAccess
      Policies: 
        - 
          PolicyName: "AmazonBraketNotebookPolicy"
          PolicyDocument: 
            Version: "2012-10-17"
            Statement: 
              - Effect: Allow
                Action:
                  - s3:GetObject
                  - s3:PutObject
                  - s3:ListBucket
                Resource:
                  - arn:aws:s3:::amazon-braket-*
                  - arn:aws:s3:::braketnotebookcdk-*
              - Effect: "Allow"
                Action: 
                  - "logs:CreateLogStream"
                  - "logs:PutLogEvents"
                  - "logs:CreateLogGroup"
                  - "logs:DescribeLogStreams"
                Resource:
                  - !Sub "arn:aws:logs:*:${AWS::AccountId}:log-group:/aws/sagemaker/*"
              - Effect: "Allow"
                Action: 
                  - braket:*
                Resource: "*"
```

## Passaggio 3: creare un'istanza di notebook SageMaker AI con il prefisso `amazon-braket-`
<a name="braket-create-cloudformation-template-step-3"></a>

Utilizza lo script del ciclo di vita SageMaker AI e il ruolo IAM creati nei passaggi 1 e 2 per creare un'istanza di notebook SageMaker AI. L'istanza del notebook è personalizzata per Braket ed è accessibile con la console Amazon Braket. Per ulteriori informazioni sulle opzioni di configurazione per questa CloudFormation risorsa, consulta [AWS::SageMaker::NotebookInstance](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-sagemaker-notebookinstance.html)la guida per l'*CloudFormation utente*.

```
BraketNotebook:
    Type: AWS::SageMaker::NotebookInstance
    Properties: 
      InstanceType: ml.t3.medium
      NotebookInstanceName: !Sub amazon-braket-notebook-${AWS::StackName}
      RoleArn: !GetAtt ExecutionRole.Arn
      VolumeSizeInGB: 30
      LifecycleConfigName: !GetAtt BraketNotebookInstanceLifecycleConfig.NotebookInstanceLifecycleConfigName
```