.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`
Pour plus d'informations sur l'image ECR disponible, consultez le [didacticiel](https://docs.aws.amazon.com/m2/latest/userguide/tutorial-build-mf.html) dans le *guide de l'AWS Mainframe Modernization utilisateur*.
+ [Le logiciel client IBM Data Server](https://www.ibm.com/docs/en/db2/11.5?topic=overviews-data-server-clients) est essentiel pour précompiler et lier les programmes COBOL Db2 dans. CodeBuild Il agit comme un pont entre le compilateur COBOL et Db2.
## Bonnes pratiques
+ Tous les programmes COBOL ne s'appuient pas sur Db2 comme couche de persistance des données. Assurez-vous que les directives de compilation pour accéder à Db2 sont appliquées uniquement aux programmes COBOL spécifiquement conçus pour interagir avec Db2. Implémentez une logique pour faire la distinction entre les programmes COBOL DB2 et les programmes COBOL qui n'utilisent pas Db2.
+ Nous vous recommandons d'éviter de compiler des programmes qui n'ont pas été modifiés. Implémentez un processus pour identifier les programmes qui nécessitent une compilation.
## Épopées
### Création de l'infrastructure cloud
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Créez un compartiment S3 pour héberger le client IBM Data Server et les artefacts du pipeline. | Vous devez configurer un compartiment S3 pour (a) télécharger le client IBM Data Server, (b) stocker votre code depuis le référentiel et (c) stocker les résultats du processus de génération.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html)Pour savoir comment créer un compartiment S3, consultez la [documentation Amazon S3.](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) | AWS général |
| Téléchargez le client IBM Data Server dans le compartiment S3. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | AWS général |
| Créez un AWS Secrets Manager secret pour vos informations d'identification DB2. | Pour créer un secret afin de stocker vos DB2 informations d'identification en toute sécurité :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html)Pour plus d'informations sur la création de secrets, consultez la [documentation de Secrets Manager](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html). | AWS général |
| Vérifiez que Db2 est accessible depuis le sous-réseau VPC. | AWS CodeBuild nécessite une connexion au serveur DB2 afin que le client du serveur de données puisse effectuer des opérations de précompilation et de liaison. Assurez-vous qu'il CodeBuild peut atteindre le serveur DB2 via une connexion sécurisée.[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | Administrateur réseau, AWS général |
### Création des artefacts de l'application
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Créez l'actif COBOL Db2. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | Développeur d’applications |
| Créez le fichier `buildspec.yml`. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | AWS DevOps |
| Connectez votre référentiel à CodePipeline. | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html)Vous aurez besoin de l'Amazon Resource Name (ARN) pour la connexion lorsque vous créerez la politique Gestion des identités et des accès AWS (IAM) pour CodePipeline une étape ultérieure. | AWS DevOps |
### Configurer les autorisations
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Créez une politique IAM pour CodeBuild. | Le CodeBuild projet nécessite l'accès à certaines ressources, notamment Secrets Manager et Amazon S3.Pour configurer les autorisations nécessaires :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html)Pour plus d'informations sur la création de politiques IAM, consultez la documentation [IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html). | AWS général |
| Créez un rôle IAM pour CodeBuild. | Pour que les politiques de sécurité soient disponibles pour CodeBuild, vous devez configurer un rôle IAM.Pour créer ce rôle, procédez comme suit :1. Sur la [console IAM](https://console.aws.amazon.com/iam), dans le volet de navigation, choisissez **Roles**, **Create Role**.3. Pour le **type d'entité fiable**, conservez le **Service AWS**paramètre par défaut.4. Dans le **champ Cas d'utilisation**, sélectionnez le CodeBuild service, puis cliquez sur **Suivant**.4. Dans la liste des stratégies IAM disponibles, recherchez la stratégie pour laquelle vous avez créé CodeBuild, puis choisissez **Next** pour l'associer au rôle.5. Spécifiez un nom pour le rôle, puis choisissez **Create role** pour l'enregistrer pour référence future dans CodeBuild.Pour plus d'informations sur la création d'un rôle IAM pour un Service AWS, consultez la documentation [IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html). | AWS général |
| Créez une politique IAM pour CodePipeline. | Le AWS CodePipeline pipeline nécessite l'accès à certaines ressources, notamment votre référentiel de code et Amazon S3.Répétez les étapes indiquées précédemment pour CodeBuild créer une politique IAM pour CodePipeline (à l'étape 2, choisissez **CodePipeline**au lieu de **CodeBuild**). | AWS DevOps |
| Créez un rôle IAM pour CodePipeline. | Pour que les politiques de sécurité soient disponibles pour CodePipeline, vous devez configurer un rôle IAM.Pour créer ce rôle, procédez comme suit :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | AWS DevOps |
### Compilez et liez le programme COBOL Db2
| Sous-tâche | Description | Compétences requises |
| --- | --- | --- |
| Créez un CodePipeline pipeline et un CodeBuild projet. | Pour créer un CodePipeline pipeline et le CodeBuild projet qui compile et lie le programme COBOL Db2 :[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/prescriptive-guidance/latest/patterns/build-cobol-db2-programs-mainframe-modernization-codebuild.html) | AWS DevOps |
| Vérifiez la sortie. | Vérifiez le succès de la compilation en consultant les journaux de CodePipeline compilation. | AWS DevOps |
| Vérifiez les résultats dans DB2. | Vérifiez la version du package dans le tableau 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 version doit correspondre à l'ID de CodeBuild build, qui se trouve `CDB2SMP` dans notre exemple :NAME VALIDATE LAST_BIND_TIME LASTUSED PKGVERSION
---------- -------- -------------------------- ---------- ----------
CDB2SMP B 2024-05-18-11.53.11.503738 01/01/0001 19
| |
## Résolution des problèmes
| Problème | Solution |
| --- | --- |
| Parfois, la AWS console change de région lorsque vous passez d'un service à l'autre. | Assurez-vous de vérifier la valeur sélectionnée Région AWS chaque fois que vous passez d'un service à l'autre.Le Région AWS sélecteur se trouve dans le coin supérieur droit de la fenêtre de console. |
| Il peut être difficile d'identifier les problèmes de connectivité Db2 à partir de CodeBuild. | Pour résoudre les problèmes de connectivité, ajoutez la commande de DB2 connexion suivante au `buildspec.yml` fichier. Cet ajout vous permet de déboguer et de résoudre les problèmes de connectivité.db2 connect to $DB_NAME user $DB2USER using $DB2PASS
|
| Parfois, le volet des rôles de la console IAM n'affiche pas immédiatement la politique IAM que vous avez créée. | En cas de retard, actualisez l'écran pour afficher les dernières informations. |
## Ressources connexes
**Documentation IBM**
+ [Types de clients et de pilotes IBM Data Server](https://www.ibm.com/docs/en/db2/11.5?topic=overviews-data-server-clients)
+ [Télécharger les types de clients et de pilotes IBM Data Server](https://www.ibm.com/support/pages/download-initial-version-115-clients-and-drivers)
**AWS documentation**
+ [Guide de l'utilisateur d'Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html)
+ [AWS CodeBuild Guide de l'utilisateur](https://docs.aws.amazon.com/codebuild/latest/userguide/welcome.html)
+ [AWS Mainframe Modernization Guide de l'utilisateur](https://docs.aws.amazon.com/m2/latest/userguide/what-is-m2.html)
+ [AWS Secrets Manager Guide de l'utilisateur](https://docs.aws.amazon.com/secretsmanager/latest/userguide/intro.html)
+ [AWS CodePipeline Guide de l'utilisateur](https://docs.aws.amazon.com/codepipeline/latest/userguide/welcome.html)
+ [AWS CodeDeploy Guide de l'utilisateur** **](https://docs.aws.amazon.com/codedeploy/latest/userguide/getting-started-codedeploy.html)
## Informations supplémentaires
**CodeBuild stratégie**
Remplacez les espaces réservés ````,, ````, et `` par vos valeurs.
```
{"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 stratégie**
Remplacez les espaces réservés `` `` par vos valeurs.
```
{
"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`**
Remplacez l'``espace réservé par le nom réel de votre compartiment 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
```