` | Developer |
### Aggiungi una nuova pipeline per un microservizio
| Operazione | Description | Competenze richieste |
| --- | --- | --- |
| Aggiungete il codice di esempio alla directory dell'applicazione. | Aggiungi la directory che contiene il codice dell'applicazione di esempio alla `monorepo-sample` directory del repository GitHub [AWS CodeCommit monorepo](https://github.com/aws-samples/monorepo-multi-pipeline-trigger) multi-pipeline triggers clonato. | Developer |
| Modificare il file `monorepo-main.json`. | Aggiungi il nome della directory del codice dell'applicazione e il nome della pipeline al file nel repository clonato. `monorepo-main.json` | Developer |
| Crea la pipeline. | Nella `Pipelines` directory del repository, aggiungi la pipeline `class` per la tua applicazione. La directory contiene due file di esempio e. `pipeline_hotsite.py` `pipeline_demo.py` Ogni file ha tre fasi: origine, compilazione e distribuzione.
È possibile copiare uno dei file e modificarlo in base ai requisiti dell'applicazione. | Developer |
| Modificare il file `monorepo_config.py`. | In`service_map`, aggiungi il nome della directory per la tua applicazione e la classe che hai creato per la pipeline.
Ad esempio, il codice seguente mostra una definizione di pipeline nella `Pipelines` directory che utilizza un file denominato `pipeline_mysample.py` con una `MySamplePipeline` classe:...
# Pipeline definition imports
from pipelines.pipeline_demo import DemoPipeline
from pipelines.pipeline_hotsite import HotsitePipeline
from pipelines.pipeline_mysample import MySamplePipeline
### Add your pipeline configuration here
service_map: Dict[str, ServicePipeline] = {
# folder-name -> pipeline-class
'demo': DemoPipeline(),
'hotsite': HotsitePipeline(),
'mysample': MySamplePipeline()
}
| Developer |
### Distribuisci lo stack MonoRepoStack
| Operazione | Description | Competenze richieste |
| --- | --- | --- |
| Distribuisci lo AWS CloudFormation stack. | Distribuisci lo AWS CloudFormation `MonoRepoStack` stack con i valori dei parametri predefiniti nella directory principale del repository clonato eseguendo il comando. `make deploy-core`
È possibile modificare il nome del repository eseguendo il comando. `make deploy-core monorepo-name=`È possibile distribuire contemporaneamente entrambe le pipeline utilizzando il comando. `make deploy monorepo-name=` | Developer |
| Convalida il repository. CodeCommit | Verifica che le tue risorse siano state create eseguendo il comando. `aws codecommit get-repository --repository-name ` Poiché lo CloudFormation stack crea il CodeCommit repository in cui è archiviato il monorepo, non eseguire il `cdk destroy MonoRepoStack ` comando se hai iniziato a inserire modifiche al monorepo. | Developer |
| Convalida i risultati dello stack. CloudFormation | Verifica che lo CloudFormation `MonoRepoStack` stack sia stato creato e configurato correttamente eseguendo il comando seguente:aws cloudformation list-stacks --stack-status-filter CREATE_COMPLETE --query 'StackSummaries[?StackName == 'MonoRepoStack']'
| Developer |
### Implementa lo stack PipelinesStack
| Operazione | Description | Competenze richieste |
| --- | --- | --- |
| Distribuisci lo CloudFormation stack. | Lo AWS CloudFormation `PipelinesStack` stack deve essere distribuito dopo aver distribuito lo stack. `MonoRepoStack` Lo stack aumenta di dimensioni quando vengono aggiunti nuovi microservizi alla base di codice di monorepo e viene ridistribuito quando viene integrato un nuovo microservizio.
Distribuisci lo stack PipelinesStack eseguendo il comando. `make deploy-pipelines`È inoltre possibile distribuire contemporaneamente entrambe le pipeline eseguendo il comando. `make deploy monorepo-name=`
Il seguente output di esempio mostra come la `PipelinesStacks` distribuzione stampa i dati URLs per i microservizi alla fine dell'implementazione:Outputs:
PipelinesStack.demourl = .cloudfront.net
PipelinesStack.hotsiteurl = .cloudfront.net
| Developer |
| Convalida i risultati dello AWS CloudFormation stack. | Verifica che lo AWS CloudFormation `PipelinesStacks` stack sia stato creato e configurato correttamente eseguendo il comando seguente:aws cloudformation list-stacks --stack-status-filter CREATE_COMPLETE UPDATE_COMPLETE --query 'StackSummaries[?StackName == 'PipelinesStack']'
| Developer |
### Eseguire la pulizia delle risorse
| Operazione | Description | Competenze richieste |
| --- | --- | --- |
| Elimina i tuoi AWS CloudFormation stack. | Esegui il comando `make destroy`. | Developer |
| Elimina i bucket S3 per le tue pipeline. | [See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html) | Developer |
## risoluzione dei problemi
| Problema | Soluzione |
| --- | --- |
| Ho riscontrato dei problemi. AWS CDK | Consulta [Risoluzione dei AWS CDK problemi più comuni](https://docs.aws.amazon.com/cdk/v2/guide/troubleshooting.html) nella documentazione di AWS CDK. |
| Ho inviato il mio codice di microservizio, ma la pipeline dei microservizi non ha funzionato. | **Convalida della configurazione**
*Verifica la configurazione della filiale:*[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
*Convalida i file di configurazione:*[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
**Risoluzione dei problemi sulla console**
*AWS CodePipeline controlli:*[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
*AWS Lambda risoluzione dei problemi:*[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html) |
| Devo ridistribuire tutti i miei microservizi. | Esistono due approcci per forzare la ridistribuzione di tutti i microservizi. Scegliete l'opzione più adatta alle vostre esigenze.
**Approccio 1: Eliminare un parametro in Parameter Store**
Questo metodo prevede l'eliminazione di un parametro specifico in Systems Manager Parameter Store che tiene traccia dell'ultimo ID di commit utilizzato per la distribuzione. Quando si rimuove questo parametro, il sistema è costretto a ridistribuire tutti i microservizi al successivo trigger, perché lo percepisce come uno stato nuovo.
Fasi:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
Pro:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
Contro:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
**Approccio 2: invia un commit in ogni sottocartella monorepo**
Questo metodo prevede di apportare una modifica minore e di inserirla in ciascuna sottocartella di microservizi all'interno del monorepo per avviare le relative pipeline individuali.
Fasi:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
Pro:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html)
Contro:[See the AWS documentation website for more details](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/automatically-detect-changes-and-initiate-different-codepipeline-pipelines-for-a-monorepo-in-codecommit.html) |
## Risorse correlate
+ [Integrazione e distribuzione continue (CI/CD) con CDK Pipelines](https://docs.aws.amazon.com/cdk/latest/guide/cdk_pipeline.html) (documentazione)AWS CDK
+ [modulo aws-cdk/pipelines](https://docs.aws.amazon.com/cdk/api/latest/docs/pipelines-readme.html) (riferimento API)AWS CDK