.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`
[https://docs.aws.amazon.com/m2/latest/userguide/tutorial-build-mf.html](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-build-mf.html)
+ [Il software IBM Data Server Client](https://www.ibm.com/docs/en/db2/11.5?topic=overviews-data-server-clients) è essenziale per precompilare e associare i programmi COBOL Db2. CodeBuild Funge da ponte tra il compilatore COBOL e Db2.
## Best practice
+ Non tutti i programmi COBOL si affidano a Db2 come livello di persistenza dei dati. Assicuratevi che le direttive di compilazione per l'accesso a Db2 siano applicate solo ai programmi COBOL progettati specificamente per interagire con Db2. Implementate una logica per distinguere tra i programmi COBOL Db2 e i programmi COBOL che non utilizzano Db2.
+ Ti consigliamo di evitare di compilare programmi che non sono stati modificati. Implementa un processo per identificare quali programmi richiedono la compilazione.
## Epiche
### Crea l'infrastruttura cloud
| Operazione | Description | Competenze richieste |
| --- | --- | --- |
| Crea un bucket S3 per ospitare il client IBM Data Server e gli artefatti della pipeline. | È necessario configurare un bucket S3 per (a) caricare IBM Data Server Client, (b) archiviare il codice dal repository e (c) archiviare i risultati del processo di compilazione.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html)Per informazioni su come creare un bucket S3, consulta la documentazione di [Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html). | Informazioni generali su AWS |
| Carica l'IBM Data Server Client nel bucket S3. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | Informazioni generali su AWS |
| Crea un Gestione dei segreti AWS segreto per le tue credenziali Db2. | Per creare un segreto per archiviare in modo sicuro le tue credenziali: DB2 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html)Per ulteriori informazioni sulla creazione di segreti, consulta la [documentazione di Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html). | Informazioni generali su AWS |
| Verifica che Db2 sia accessibile dalla sottorete VPC. | AWS CodeBuild necessita di una connessione al server Db2 in modo che il Data Server Client possa eseguire operazioni di precompilazione e associazione. Assicurati che CodeBuild possa raggiungere il server Db2 tramite una connessione sicura.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | Amministratore di rete, General AWS |
### Crea gli artefatti dell'applicazione
| Operazione | Description | Competenze richieste |
| --- | --- | --- |
| Create la risorsa COBOL Db2. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | Sviluppatore di app |
| Crea il file `buildspec.yml`. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | AWS DevOps |
| Connect il tuo repository a. CodePipeline | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html)Avrai bisogno dell'Amazon Resource Name (ARN) per la connessione quando crei la policy AWS Identity and Access Management (IAM) per una CodePipeline fase successiva. | AWS DevOps |
### Configurazione delle autorizzazioni
| Operazione | Description | Competenze richieste |
| --- | --- | --- |
| Crea una policy IAM per CodeBuild. | Il CodeBuild progetto richiede l'accesso ad alcune risorse, tra cui Secrets Manager e Amazon S3.Per configurare le autorizzazioni necessarie:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html)Per ulteriori informazioni sulla creazione di policy IAM, consulta la [documentazione IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html). | Informazioni generali su AWS |
| Crea un ruolo IAM per CodeBuild. | Per rendere disponibili le politiche di sicurezza CodeBuild, devi configurare un ruolo IAM.Per creare questo ruolo:1. Sulla [console IAM](https://console.aws.amazon.com/iam), nel riquadro di navigazione, scegli **Ruoli**, **Crea ruolo**.3. Per il **tipo di entità affidabile**, mantieni l'**Servizio AWS**impostazione predefinita.4. Per **Caso d'uso**, seleziona il CodeBuild servizio, quindi scegli **Avanti**.4. Nell'elenco delle policy IAM disponibili, individua la policy per cui hai creato CodeBuild, quindi scegli **Avanti** per associarla al ruolo.5. Specificate un nome per il ruolo e scegliete **Crea ruolo** per salvarlo per riferimenti futuri in CodeBuild.Per ulteriori informazioni sulla creazione di un ruolo IAM per un Servizio AWS, consulta la [documentazione IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html). | Informazioni generali su AWS |
| Crea una policy IAM per CodePipeline. | La AWS CodePipeline pipeline richiede l'accesso ad alcune risorse, tra cui il repository di codice e Amazon S3.Ripeti i passaggi forniti in precedenza per CodeBuild creare una policy IAM per CodePipeline (nel passaggio 2, scegli **CodePipeline**invece di). **CodeBuild** | AWS DevOps |
| Crea un ruolo IAM per CodePipeline. | Per rendere disponibili le politiche di sicurezza CodePipeline, devi configurare un ruolo IAM.Per creare questo ruolo:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | AWS DevOps |
### Compila e associa il programma COBOL Db2
| Operazione | Description | Competenze richieste |
| --- | --- | --- |
| Crea una CodePipeline pipeline e un CodeBuild progetto. | Per creare una CodePipeline pipeline e il CodeBuild progetto che compila e associa il programma COBOL Db2:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | AWS DevOps |
| Esamina l'output. | Verifica il successo della build esaminando i log di CodePipeline compilazione. | AWS DevOps |
| Controlla i risultati in Db2. | Verifica la versione del pacchetto nella tabella SYSPLAN.select CAST(NAME AS VARCHAR(10)) as name, VALIDATE, LAST_BIND_TIME, LASTUSED, CAST(PKGVERSION AS VARCHAR(10)) as PKGVERSION from SYSIBM.SYSPLAN where NAME = 'CDB2SMP' order by LAST_BIND_TIME desc
La versione deve corrispondere all'ID di CodeBuild build, che è `CDB2SMP` nel nostro esempio:NAME VALIDATE LAST_BIND_TIME LASTUSED PKGVERSION
---------- -------- -------------------------- ---------- ----------
CDB2SMP B 2024-05-18-11.53.11.503738 01/01/0001 19
| |
## risoluzione dei problemi
| Problema | Soluzione |
| --- | --- |
| Occasionalmente, la AWS console cambia regione quando ci si sposta da un servizio all'altro. | Assicurati di verificare la selezione Regione AWS ogni volta che passi da un servizio all'altro.Il Regione AWS selettore si trova nell'angolo superiore destro della finestra della console. |
| Può essere difficile identificare i problemi di connettività di Db2. CodeBuild | Per risolvere i problemi di connettività, aggiungi il seguente comando DB2 connect al file. `buildspec.yml` Questa aggiunta consente di eseguire il debug e risolvere i problemi di connettività.db2 connect to $DB_NAME user $DB2USER using $DB2PASS
|
| A volte, il riquadro dei ruoli nella console IAM non mostra immediatamente la policy IAM che hai creato. | Se riscontri un ritardo, aggiorna lo schermo per visualizzare le informazioni più recenti. |
## Risorse correlate
**Documentazione IBM**
+ [Client e tipi di driver IBM Data Server](https://www.ibm.com/docs/en/db2/11.5?topic=overviews-data-server-clients)
+ [Scarica i tipi di client e driver IBM Data Server](https://www.ibm.com/support/pages/download-initial-version-115-clients-and-drivers)
**AWS documentazione**
+ [Guida per l'utente di Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)
+ [AWS CodeBuild Guida per l'utente](https://docs.aws.amazon.com/codebuild/latest/userguide/welcome.html)
+ [Modernizzazione del mainframe AWS Guida per l'utente](https://docs.aws.amazon.com/m2/latest/userguide/what-is-m2.html)
+ [Gestione dei segreti AWS Guida per l'utente](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)
+ [AWS CodePipeline Guida per l'utente](https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html)
+ [AWS CodeDeploy Guida per l'utente** **](https://docs.aws.amazon.com/codedeploy/latest/userguide/getting-started-codedeploy.html)
## Informazioni aggiuntive
**CodeBuild policy**
Sostituisci i segnaposto``,, `` ````, e `` con i tuoi valori.
```
{"Version": "2012-10-17",
"Statement": [
{"Action": "ecr:GetAuthorizationToken", "Effect": "Allow", "Resource": "*" },
{"Action": ["ecr:GetDownloadUrlForLayer", "ecr:BatchGetImage",
"ecr:BatchCheckLayerAvailability"],
"Effect": "Allow",
"Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools"},
{"Action": "s3:PutObject", "Effect": "Allow", "Resource": "arn:aws:s3:::aws-m2-repo-*/*"},
{"Action": ["logs:PutLogEvents", "logs:CreateLogStream", "logs:CreateLogGroup"],
"Effect": "Allow", "Resource": "arn:aws:logs:::*"},
{"Action": ["ec2:DescribeVpcs", "ec2:DescribeSubnets",
"ec2:DescribeSecurityGroups", "ec2:DescribeNetworkInterfaces",
"ec2:DescribeDhcpOptions", "ec2:DeleteNetworkInterface",
"ec2:CreateNetworkInterface"],
"Effect": "Allow", "Resource": "*"},
{"Action": "ec2:CreateNetworkInterfacePermission",
"Effect": "Allow", "Resource": [""]},
{"Action": "s3:*", "Effect": "Allow", "Resource": ["/*",""]},
{"Action": "secretsmanager:GetSecretValue",
"Effect": "Allow", "Resource": ""}
]
}
```
**CodePipeline policy**
Sostituisci i segnaposto `` e `` con i tuoi valori.
```
{
"Version": "2012-10-17",
"Statement": [
{"Action": ["s3:List*", "s3:GetObjectVersion", "s3:GetObject", "s3:GetBucketVersioning" ],
"Effect": "Allow",
"Resource": ["/*", ""]},
{"Action": ["codebuild:StartBuild", "codebuild:BatchGetBuilds"],
"Effect": "Allow", "Resource": "*"},
{"Action": ["codestar-connections:UseConnection"],
"Effect": "Allow", "Resource": ""}
]
}
```
**`buildspec.yml`**
Sostituisci il `` segnaposto con il nome effettivo del bucket S3.
```
version: 0.2
phases:
pre_build:
commands:
- /var/microfocuslicensing/bin/mfcesd -no > /var/microfocuslicensing/logs/mfcesd_startup.log 2>&1 &
- |
mkdir $CODEBUILD_SRC_DIR/db2client
aws s3 cp s3:///v11.5.8_linuxx64_client.tar.gz $CODEBUILD_SRC_DIR/db2client/ >> /dev/null 2>&1
tar -xf $CODEBUILD_SRC_DIR/db2client/v11.5.8_linuxx64_client.tar.gz -C $CODEBUILD_SRC_DIR/db2client/
cd $CODEBUILD_SRC_DIR/db2client/
./client/db2_install -f sysreq -y -b /opt/ibm/db2/V11.5 >> /dev/null 2>&1
useradd db2cli
/opt/ibm/db2/V11.5/instance/db2icrt -s client -u db2cli db2cli
DB2CRED=$(aws secretsmanager get-secret-value --secret-id dev-db2-cred | jq -r '.SecretString | fromjson')
read -r DB2USER DB2PASS DB_NODE DB_HOST DB_PORT DB_NAME DB_QUAL <<<$(echo $DB2CRED | jq -r '.username, .password, .db2node, .db2host, .db2port, .db2name, .qualifier')
. /home/db2cli/sqllib/db2profile
db2 catalog tcpip node $DB_NODE remote $DB_HOST server $DB_PORT
db2 catalog db $DB_NAME as $DB_NAME at node $DB_NODE authentication server
build:
commands:
- |
revision=$CODEBUILD_SRC_DIR/loadlib
mkdir -p $revision; cd $revision
. /opt/microfocus/EnterpriseDeveloper/bin/cobsetenv
cob -zU $CODEBUILD_SRC_DIR/CDB2SMP.cbl -C "DB2(DB==${DB_NAME} PASS==${DB2USER}.${DB2PASS} VERSION==${CODEBUILD_BUILD_NUMBER} COLLECTION==DB2AWSDB"
artifacts:
files:
- "**/*"
base-directory: $revision
```