Creazione di un progetto in AWS CodeStar

Utilizza la console AWS CodeStar per creare un progetto. Se utilizzi un modello di progetto, le risorse necessarie saranno già configurate. Il modello include anche il codice di esempio che puoi utilizzare per avviare la codifica.

Per creare un progetto, accedi a AWS Management Console con un utente IAM che dispone della AWSCodeStarFullAccess policy o di autorizzazioni equivalenti. Per ulteriori informazioni, consulta Configurazione AWS CodeStar.

Nota

È necessario completare i passaggi indicati Configurazione AWS CodeStar prima di poter completare le procedure descritte in questo argomento.

Creazione di un progetto in AWS CodeStar (console)

Utilizza la console AWS CodeStar per creare un progetto.

Per creare un progetto in AWS CodeStar

1. Accedere aAWS Management Console, quindi aprire la AWS CodeStar console all'indirizzo https://console.aws.amazon.com/codestar/.

   Verifica di aver effettuato la registrazione alla regione AWS in cui desideri creare il progetto e le rispettive risorse. Ad esempio, per creare un progetto negli Stati Uniti orientali (Ohio), assicurati di aver selezionato quella AWS regione. Per informazioni sulle regioni AWS in cui AWS CodeStar è disponibile, consulta Regioni ed endpoint in Riferimenti generali di AWS.

2. Nella AWS CodeStarpagina, scegli Crea progetto.

3. Nella pagina Scegli un modello di progetto, scegli il tipo di progetto dall'elenco dei modelli di AWS CodeStar progetto. Puoi utilizzare la barra dei filtri per ridurre la scelta. Ad esempio, per un progetto di applicazione Web scritto in Node.js da distribuire su istanze Amazon EC2, seleziona le caselle di controllo Applicazione Web, Node.js e Amazon EC2. Quindi scegli tra i modelli disponibili per quel set di opzioni.

   Per ulteriori informazioni, consulta Modelli di progetto AWS CodeStar.

4. Seleziona Next (Successivo).

5. Nel campo di immissione del testo del nome del progetto, inserisci un nome per il progetto, ad esempio My First Project. In Project ID, l'ID del progetto deriva dal nome di questo progetto, ma è limitato a 15 caratteri.

   Ad esempio, l'ID predefinito per un progetto denominato My First Project è my-first-projec. Questo ID di progetto è la base per i nomi di tutte le risorse associate al progetto. AWS CodeStarutilizza questo ID di progetto come parte dell'URL per il repository di codice e per i nomi dei ruoli e delle politiche di accesso di sicurezza correlati in IAM. Dopo la creazione del progetto. l'ID del progetto non può essere modificato. Per modificare l'ID del progetto prima di creare il progetto, in ID progetto, inserisci l'ID che desideri utilizzare.

   Per ulteriori informazioni sui limiti per i nomi e gli ID del progetto, consulta Limiti in AWS CodeStar.

   Nota

   Gli ID del progetto devono essere univoci per l'account AWS in una regione AWS.

6. Scegli il fornitore del repository AWS CodeCommitoppure GitHub.

7. Se selezioni AWS CodeCommit, per il Repository name (Nome del repository), accetta il nome del repository AWS CodeCommit predefinito, oppure inseriscine un altro. Quindi vai avanti al passaggio 9.

8. Se hai scelto GitHub, devi scegliere o creare una risorsa di connessione. Se hai una connessione esistente, selezionala nel campo di ricerca. Altrimenti, crea subito una nuova connessione. Scegli Connect a GitHub.

   Viene visualizzata la pagina Crea una connessione.

   Nota

   Per creare una connessione, è necessario disporre di un GitHub account. Se stai creando una connessione per un'organizzazione, devi essere il proprietario dell'organizzazione.

   

   1. In Crea connessione all' GitHub app, nel campo di testo di immissione del nome della connessione, inserisci un nome per la connessione. Scegli Connect a GitHub.

      La GitHub pagina Connect to visualizza e mostra il campo GitHub App.

   2. In GitHub App, scegli l'installazione di un'app o scegli Installa una nuova app per crearne una.

      Nota

      È sufficiente installare una sola app per tutte le connessioni a un provider specifico. Se hai già installato il AWS Connector for GitHub app, sceglilo e salta questo passaggio.

   3. Nella GitHub pagina Installa AWS Connector per, scegli l'account in cui desideri installare l'app.

      Nota

      Se hai già installato l'app, puoi scegliere Configure (Configura) per passare a una pagina di modifica per l'installazione dell'app oppure è possibile utilizzare il pulsante Indietro per tornare alla console.

   4. Se viene visualizzata la pagina Conferma la password per continuare, inserisci GitHub la password, quindi scegli Accedi.

   5. Nella GitHub pagina Install AWS Connector per, mantieni le impostazioni predefinite e scegli Installa.

   6. Nella GitHub pagina Connect to, l'ID di installazione per la nuova installazione viene visualizzato nel campo di immissione di testo GitHub App.

      Dopo aver creato la connessione, nella pagina di CodeStar creazione del progetto viene visualizzato il messaggio Ready to connect.

      Nota

      Puoi visualizzare la tua connessione in Impostazioni nella console Developer Tools. Per ulteriori informazioni, consulta Guida introduttiva alle connessioni.

      

   7. Per il proprietario del repository, scegli l' GitHub organizzazione o il tuo account personale. GitHub

   8. Per Nome del repository, accetta il nome del GitHub repository predefinito o inseriscine uno diverso.

   9. Scegli Pubblico o Privato.

      Nota

      Per utilizzarlo AWS Cloud9 come ambiente di sviluppo, devi scegliere Pubblico.

   10. (Facoltativo) Per la descrizione del repository, inserite una descrizione per il GitHub repository.

   Nota

   Se scegli un modello di progetto Alexa Skill, devi collegare un account sviluppatore Amazon. Per ulteriori informazioni su come lavorare con i progetti Alexa Skill, consulta. Tutorial: crea un progetto Alexa Skill in AWS CodeStar

9. Se il tuo progetto è distribuito su istanze Amazon EC2 e desideri apportare modifiche, configura le istanze Amazon EC2 in Amazon EC2 Configuration. Ad esempio, è possibile scegliere tra i tipi di istanze disponibili per il progetto.

   Nota

   I diversi tipi di istanze Amazon EC2 offrono diversi livelli di potenza di calcolo e possono avere costi associati diversi. Per ulteriori informazioni, consulta i tipi di istanze di Amazon EC2 e i prezzi di Amazon EC2.

   Se disponi di più di un cloud privato virtuale (VPC) o più sottoreti create in Amazon Virtual Private Cloud, puoi anche scegliere il VPC e la sottorete da utilizzare. Tuttavia, se scegli un tipo di istanza Amazon EC2 che non è supportato su istanze dedicate, non puoi scegliere un VPC la cui tenancy dell'istanza è impostata su Dedicato.

   Per ulteriori informazioni, consulta Che cos'è Amazon VPC? e nozioni di base sulle istanze dedicate.

   In Coppia di chiavi, scegli la coppia di chiavi Amazon EC2 in cui hai creato. Fase 4: creare una coppia di chiavi Amazon EC2 per progetti AWS CodeStar Seleziona Riconosco di avere accesso al file della chiave privata.

10. Seleziona Successivo.

11. Esaminare le risorse e i dettagli di configurazione.

12. Scegli Next (Avanti) oppure Create project (Crea progetto). (L'opzione visualizzata dipende dal modello di progetto).

    Potrebbero essere necessari alcuni minuti per creare il progetto, incluso il repository.

13. Dopo che il progetto ha un repository, puoi utilizzare la pagina Repository per configurarne l'accesso. Usa i link nei passaggi successivi per configurare un IDE, impostare il monitoraggio dei problemi o aggiungere membri del team al tuo progetto.

Durante la creazione del progetto, è possibile aggiungere membri del team o configurare l'accesso al repository del progetto dalla riga di comando o dall'IDE preferito.

Creazione di un progetto in AWS CodeStar (AWS CLI)

Un progetto AWS CodeStar è una combinazione di codice sorgente e le risorse create per distribuire il codice. Le risorse che supportano la compilazione, il rilascio e la distribuzione del codice sono denominate risorse della toolchain. Al momento della creazione del progetto, un modello AWS CloudFormation ti fornisce le risorse della toolchain in una pipeline per l'integrazione e la distribuzione continue (CI/CD).

Quando utilizzi la console per creare un progetto, il modello di toolchain viene creato per te. Se per creare un progetto utilizzi AWS CLI, devi creare il modello di toolchain che crea le relative risorse.

Per una toolchain completa sono richieste le seguenti risorse consigliate:

1. Un CodeCommit o un GitHub repository che contiene il tuo codice sorgente.

2. Una CodePipeline pipeline configurata per ascoltare le modifiche al tuo repository.

   1. Quando lo utilizzi CodeBuild per eseguire test unitari o di integrazione, ti consigliamo di aggiungere una fase di compilazione alla pipeline per creare artefatti di compilazione.

   2. Ti consigliamo di aggiungere alla tua pipeline una fase di distribuzione che utilizzi CodeDeploy o distribuisca gli artefatti AWS CloudFormation di build e il codice sorgente nell'infrastruttura di runtime.

      Nota

      Poiché CodePipeline richiede almeno due fasi in una pipeline e la prima fase deve essere la fase di origine, aggiungi una fase di compilazione o distribuzione come seconda fase.

AWS CodeStarLe toolchain sono definite come modelli. CloudFormation

Per un tutorial dettagliato di questa attività e della configurazione delle risorse di esempio, consultare Esercitazione: creazione di un progetto in AWS CodeStar con la AWS CLI.

Prerequisiti:

Quando crei un progetto, devi fornire i seguenti parametri in un file di input. Se non vengono forniti, AWS CodeStar crea un progetto vuoto.

• Codice sorgente. Se questo parametro è incluso nella tua richiesta, devi includere anche un modello di toolchain.

  • Il codice sorgente deve includere il codice dell'applicazione richiesto per l'esecuzione del progetto.

  • Il codice sorgente deve includere tutti i file di configurazione richiesti, come un buildspec.yml per un CodeBuild progetto o un appspec.yml per una distribuzione. CodeDeploy

  • È possibile includere elementi opzionali nel codice sorgente, ad esempio un README o un template.yml per risorse non appartenenti alla toolchain. AWS

• modello di toolchain. Il modello di toolchain fornisce le AWS risorse e i ruoli IAM da gestire per il progetto.

• Posizione di origine. Se per il tuo progetto specifichi un codice sorgente e un modello di toolchain, devi fornire una posizione. Carica i tuoi file sorgente e il tuo modello di toolchain nel bucket Amazon S3. AWS CodeStarrecupera i file e li usa per creare il progetto.

Importante

Assicurati di configurare la AWS regione preferita in. AWS CLI Il progetto viene creato nella AWS regione configurata inAWS CLI.

1. Eseguire il comando create-project e includere il parametro --generate-cli-skeleton:

   aws codestar create-project --generate-cli-skeleton

   Nell'output vengono visualizzati dati in formato JSON. Copiare i dati in un file, ad esempio input.json, in un percorso nel computer locale o sull'istanza in cui è installata la AWS CLI. Modificare i dati copiati come segue, quindi salvare i risultati.

   {
       "name": "project-name", 
       "id": "project-id", 
       "description": "description", 
       "sourceCode": [
           {
               "source": {
                   "s3": {
                       "bucketName": "s3-bucket-name", 
                       "bucketKey": "s3-bucket-object-key"
                   }
               }, 
               "destination": {
                   "codeCommit": {
                       "name": "codecommit-repository-name"
                   }, 
                   "gitHub": {
                       "name": "github-repository-name", 
                       "description": "github-repository-description", 
                       "type": "github-repository-type", 
                       "owner": "github-repository-owner", 
                       "privateRepository": true, 
                       "issuesEnabled": true, 
                       "token": "github-personal-access-token"
                   }
               }
           }
       ], 
       "toolchain": {
           "source": {
               "s3": {
                   "bucketName": "s3-bucket-name", 
                   "bucketKey": "s3-bucket-object-key"
               }
           }, 
           "roleArn": "service-role-arn", 
           "stackParameters": {
               "KeyName": "key-name"
           }
       }, 
       "tags": {
           "KeyName": "key-name"
       }
   }

   Sostituire quanto segue:

   • project-name: obbligatorio. Il nome di questo progetto AWS CodeStar.

   • project-id: obbligatorio. L'ID di questo progetto AWS CodeStar.

     Nota

     Al momento della creazione di un progetto, è necessario disporre di un ID del progetto univoco. Se si invia un file di input con un ID del progetto esistente, si riceverà un errore.

   • description: facoltativo. La descrizione di questo progetto AWS CodeStar.

   • sourceCode: facoltativo. Le informazioni di configurazione del codice sorgente fornito per il progetto. Al momento, è supportato un singolo oggetto sourceCode. Ogni oggetto sourceCode contiene informazioni sulla posizione in cui il codice sorgente viene recuperato da AWS CodeStar e la destinazione in cui il codice sorgente è compilato.

     • source: obbligatorio. Definisce il percorso in cui è stato caricato il codice sorgente. L'unica fonte supportata è Amazon S3. AWS CodeStarrecupera il codice sorgente e lo include nel repository dopo la creazione del progetto.

       • S3: facoltativo. La posizione Amazon S3 del tuo codice sorgente.

         • bucket-name: il bucket che contiene il codice sorgente.

         • bucket-key: il prefisso del bucket e la chiave dell'oggetto che puntano al file .zip contenente il codice sorgente (ad esempio, src.zip).

     • destination: facoltativo. Le posizioni di destinazione in cui il codice sorgente deve essere compilato quando viene creato il progetto. Le destinazioni supportate per il codice sorgente sono CodeCommit e GitHub.

       È possibile fornire solo una di queste due opzioni:

       • CodeCommit: l'unico attributo obbligatorio è il nome del CodeCommit repository che dovrebbe contenere il codice sorgente. Questo repository deve trovarsi nel modello di toolchain.

         Nota

         Infatti CodeCommit, è necessario fornire il nome del repository definito nello stack della toolchain. AWS CodeStarinizializza questo repository con il codice sorgente fornito in Amazon S3.

       • GitHub: questo oggetto rappresenta le informazioni necessarie per creare GitHub il repository e inserirlo con il codice sorgente. Se scegli un GitHub repository, sono richiesti i seguenti valori.

         Nota

         Infatti GitHub, non è possibile specificare un GitHub repository esistente. AWS CodeStarne crea uno per te e popola questo repository con il codice sorgente che hai caricato su Amazon S3. AWS CodeStarutilizza le seguenti informazioni per creare il tuo repository in. GitHub

         • name: obbligatorio. Il nome del tuo GitHub repository.

         • description: obbligatoria. La descrizione del tuo GitHub repository.

         • type: obbligatorio. Il tipo di GitHub repository. I valori validi sono User o Organization.

         • owner: obbligatorio. Il nome GitHub utente del proprietario del repository. Se il repository deve essere di proprietà di un' GitHub organizzazione, fornisci il nome dell'organizzazione.

         • privateRepository: obbligatorio. Per definire se il repository è privato o pubblico. I valori validi sono true o false.

         • issuesEnabled: obbligatorio. Se desideri abilitare i problemi in GitHub questo repository. I valori validi sono true o false.

         • token: Facoltativo. Si tratta di un token di accesso personale AWS CodeStar utilizzato per accedere al tuo GitHub account. Il token deve contenere i seguenti ambiti: repo, user e admin:repo_hook. Per recuperare un token di accesso personale da GitHub, consulta Creazione di un token di accesso personale per la riga di comando sul GitHub sito Web.

           Nota

           Se utilizzi la CLI per creare un progetto con un repository di GitHub origine, AWS CodeStar utilizza il tuo token per accedere al repository tramite le app OAuth. Se utilizzi la console per creare un progetto con un repository di origine, AWS CodeStar utilizza una GitHub risorsa di connessione, che accede al repository con le app. GitHub

       • toolchain: informazioni sulla toolchain CI/CD da configurare quando viene creato il progetto. Ciò include il percorso sul quale è stato caricato il modello di toolchain. Il modello crea lo stack AWS CloudFormation che contiene le risorse della toolchain. Sono inoltre inclusi eventuali parametri sostitutivi ai quali AWS CloudFormation deve fare riferimento e il ruolo da utilizzare per creare lo stack. AWS CodeStar recupera il modello e utilizza AWS CloudFormation per eseguirlo, creando così le risorse della toolchain.

         • source: obbligatorio. La posizione del modello di toolchain. Amazon S3 è l'unica posizione di origine supportata.

           • S3: facoltativo. La posizione Amazon S3 in cui hai caricato il modello di toolchain.

             • bucket-name: il nome del bucket Amazon S3.

             • bucket-key: il prefisso del bucket e la chiave dell'oggetto che puntano al file .yml o .json contenente il modello di toolchain (ad esempio, files/toolchain.yml).

         • stackParameters: facoltativo. Contiene coppie chiave-valore da passare a AWS CloudFormation. Si tratta dei parametri, se disponibili, ai quali il modello di toolchain fa riferimento.

         • role: facoltativo. Il ruolo utilizzato per creare le risorse della toolchain nell'account dell'utente. Il ruolo è richiesto come di seguito specificato:

           • Se non viene indicato un ruolo, in caso di toolchain derivante da un modello rapido di AWS CodeStar, AWS CodeStar usa il ruolo di servizio di default creato per l'account. Se il ruolo del servizio non esiste nell'account dell'utente, è possibile crearne uno. Per informazioni, consulta Fase 2: Creare il ruolo AWS CodeStar di servizio.

           • Se stai caricando e utilizzando il tuo modello personalizzato di toolchain è necessario specificare il ruolo. È possibile creare un ruolo in base al ruolo del servizio e alla dichiarazione di policy di AWS CodeStar. Per un esempio di questa dichiarazione di policy, consulta AWSCodeStarServiceRole Politica.

       • tags: facoltativo. I tag collegati al progetto AWS CodeStar.

         Nota

         Questi tag non sono collegati alle risorse contenute nel progetto.

2. Passare alla directory contenente il file appena salvato ed eseguire nuovamente il comando create-project. Includere il parametro --cli-input-json.

   aws codestar create-project --cli-input-json file://input.json

3. Se eseguito correttamente, nell'output compaiono dei dati simili ai seguenti:

   {
       "id": "project-ID",
       "arn": "arn"
   }

   • L'output contiene informazioni sul nuovo progetto.:

     • Il valore id rappresenta l'ID del progetto.

     • Il valore arn rappresenta l'ARN del progetto.

4. Per controllare lo stato della creazione del progetto, utilizzare il comando describe-project. Includere il parametro --id.

   aws codestar describe-project --id <project_ID> 

   Nell'output compaiono informazioni simili alle seguenti:

   {
       "name": "MyProject",
       "id": "myproject",
       "arn": "arn:aws:codestar:us-east-1:account_ID:project/myproject",
       "description": "",
       "createdTimeStamp": 1539700079.472,
       "stackId": "arn:aws:cloudformation:us-east-1:account_ID:stack/awscodestar-myproject/stack-ID",
       "status": {
           "state": "CreateInProgress"
       }
   }

   • L'output contiene informazioni sul nuovo progetto.:

     • Il valore state rappresenta lo stato della creazione del progetto, ad esempio CreateInProgress o CreateComplete.

Durante la creazione del progetto, è possibile aggiungere membri del team o configurare l'accesso al repository del progetto dalla riga di comando o dall'IDE preferito.