Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Création d'une CEV
Vous pouvez créer une CEV à l'aide de la AWS Management Console ou de la AWS CLI. Spécifiez l'architecture multilocataire ou non multilocataire. Pour plus d’informations, consultez [Considérations relatives à l'architecture multilocataire](custom-creating.md#custom-creating.overview).
En général, la création d'une CEV prend environ deux heures. Après avoir créé la CEV, vous pouvez l’utiliser pour créer ou mettre à niveau une instance de base de données RDS Custom. Pour plus d’informations, consultez [Création d'une instance de base de données RDS Custom for Oracle](custom-creating.md#custom-creating.create) et [Mise à niveau d'une instance de base de données RDS Custom for Oracle](custom-upgrading-modify.md).
**Note**
Si votre instance de base de données utilise actuellement Oracle Linux 7.9, créez une nouvelle CEV qui utilise la dernière AMI, qui utilise Oracle Linux 8. Modifiez ensuite votre instance pour utiliser la nouvelle CEV.
Prenez note des exigences et limitations suivantes pour créer une CEV :
+ Le compartiment Amazon S3 contenant vos fichiers d’installation doit se trouver dans la même Région AWS que votre CEV. Sinon, le processus de création échoue.
+ Le nom de la CEV doit être au format `major-engine-version.customized_string`, comme dans `19.cdb_cev1`.
+ Le nom de la CEV doit contenir entre 1 et 50 caractères alphanumériques, des traits de soulignement, des tirets ou des points.
+ Le nom de la CEV ne peut pas contenir de points consécutifs, comme dans `19..cdb_cev1`.
## Console
**Pour créer une CEV**
1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Dans le panneau de navigation, choisissez **Custom engine versions** (Versions de moteur personnalisées).
La page **Custom engine versions** (Versions de moteur personnalisées) affiche toutes les CEV qui existent actuellement. Si vous n'avez pas créé de CEV, la page est vide.
1. Choisissez **Create custom engine version** (Créer une version de moteur personnalisée).
1. Dans **Options de moteur**, procédez comme suit :
1. Pour **Engine type** (Type de moteur), choisissez **Oracle**.
1. Pour **Paramètres d’architecture**, vous pouvez choisir **Architecture à locataires multiples** pour créer une CEV à locataires multiples Oracle qui utilise le moteur de base de données `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`. Vous pouvez créer une base de données CDB RDS Custom for Oracle avec une version CEV multi-locataire. Si vous ne choisissez pas cette option, votre CEV est une base de données non CDB, qui utilise le moteur `custom-oracle-ee` ou `custom-oracle-se2`.
**Note**
L'architecture que vous choisissez est une caractéristique permanente de votre version CEV. Vous ne pouvez pas modifier votre CEV pour utiliser une architecture différente ultérieurement.
1. Choisissez l’une des options suivantes :
+ **Créer un nouveau CEV** — Créez un CEV à partir de zéro. Dans ce cas, vous devez spécifier un manifeste JSON indiquant les fichiers binaires de la base de données.
+ **Créer CEV à partir de la source** — Dans **Spécifiez le CEV que vous souhaitez copier**, choisissez un CEV existant à utiliser comme CEV source. Dans ce cas, vous pouvez spécifier une nouvelle Amazon Machine Image (AMI), mais vous ne pouvez pas spécifier de fichiers binaires de base de données différents.
1. Pour **Version du moteur**, choisissez la version majeure du moteur.
1. Dans **Détails de la version**, procédez comme suit :
1. Saisissez un nom valide dans **Nom de version de moteur personnalisée**. Par exemple, vous pouvez saisir le nom **19.cdb\$1cev1**.
1. (Facultatif) Saisissez une description pour votre CEV.
1. Dans **Média d'installation**, procédez comme suit :
1. (Facultatif) Dans le champ **ID d'AMI**, laissez le champ vide pour utiliser la dernière AMI fournie par le service ou saisissez une AMI que vous avez utilisée précédemment pour créer un CEV. Pour obtenir des ID d'AMI valides, utilisez l'une des techniques suivantes :
+ Dans la console, choisissez **Versions de moteur personnalisées** dans le panneau de navigation de gauche, puis choisissez le nom d’une CEV. L'ID AMI utilisé par la CEV apparaît dans l'onglet **Configuration**.
+ Dans l'AWS CLI, utilisez la commande `describe-db-engine-versions`. Recherchez la sortie pour `ImageID`.
1. Pour **S3 location of manifest files** (Emplacement S3 des fichiers manifestes), saisissez l'emplacement du compartiment Amazon S3 que vous avez spécifié dans [Étape 3 : Charger vos fichiers d'installation dans Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3). Par exemple, saisissez **s3://my-custom-installation-files/123456789012/cev1/**.
**Note**
La Région AWS dans laquelle vous créer le CEV doit se trouver dans la même région que le compartiment S3.
1. (Créer un nouveau CEV uniquement) Pour **Manifeste CEV**, saisissez le manifeste JSON que vous avez créé dans [Création du manifeste CEV](custom-cev.preparing.md#custom-cev.preparing.manifest.creating).
1. Dans la section **Clé KMS**, sélectionnez **Entrez un ARN de clé** pour répertorier les clés AWS KMS disponibles. Sélectionnez ensuite votre clé KMS dans la liste.
Une clé AWS KMS est nécessaire pour RDS Custom. Pour plus d’informations, consultez [Étape 1 : créer ou réutiliser une clé de chiffrement AWS KMS symétrique](custom-setup-orcl.md#custom-setup-orcl.cmk).
1. (Facultatif) Choisissez **Ajouter une nouvelle balise** pour créer une paire clé-valeur pour votre CEV.
1. Choisissez **Create custom engine version** (Créer une version de moteur personnalisée).
Si le manifeste JSON n'est pas dans un format valide, la console affiche **Erreur lors de la validation du manifeste CEV**. Résolvez les problèmes et réessayez.
La page **Custom engine versions** (Versions de moteur personnalisées) s'affiche. Votre CEV s'affiche avec le statut **Creating** (Création). Le processus de création d'un CEV prend environ deux heures.
## AWS CLI
Pour créer une CEV à l'aide de la AWS CLI, exécutez la commande [create custom-db-engine version](https://docs.aws.amazon.com/cli/latest/reference/rds/create-custom-db-engine-version.html).
Les options suivantes sont requises :
+ `--engine` – Spécifier le type de moteur. Pour une CDB, spécifiez `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`. Pour un objet autre qu’une CDB, spécifiez `custom-oracle-ee` ou `custom-oracle-se2`. Vous pouvez créer des CDB uniquement à partir d’une CEV créée avec `custom-oracle-ee-cdb` ou `custom-oracle-se2-cdb`. Vous pouvez créer des bases de données non CDB uniquement à partir d’une CEV créée avec `custom-oracle-ee` ou `custom-oracle-se2`.
+ `--engine-version` : spécifiez la version du moteur. Le format est *version-majeure-moteur*.*chaîne\$1personnalisée*. Le nom de la CEV doit contenir entre 1 et 50 caractères alphanumériques, des traits de soulignement, des tirets ou des points. Le nom de la CEV ne peut pas contenir de points consécutifs, comme dans `19..cdb_cev1`.
+ `--kms-key-id` : spécifiez une AWS KMS key.
+ `--manifest` : spécifiez `manifest_json_string` ou `--manifest file:file_name`. Les caractères de saut de ligne ne sont pas autorisés dans `manifest_json_string`. Assurez-vous d'échapper les guillemets doubles (") dans le code JSON en les faisant précéder d'une barre oblique inversée (\$1).
L'exemple suivant illustre la `manifest_json_string` pour 19c à partir de [Étape 5 : Préparer le manifeste CEV](custom-cev.preparing.md#custom-cev.preparing.manifest). L'exemple définit de nouvelles valeurs pour la base Oracle, le répertoire de base de base de données Oracle, ainsi que l'ID et le nom de l'utilisateur et du groupe UNIX/Linux. Si vous copiez cette chaîne, supprimez tous les caractères de saut de ligne avant de la coller dans votre commande.
`"{\"mediaImportTemplateVersion\": \"2020-08-14\",\"databaseInstallationFileNames\": [\"V982063-01.zip\"],\"opatchFileNames\": [\"p6880880_190000_Linux-x86-64.zip\"],\"psuRuPatchFileNames\": [\"p32126828_190000_Linux-x86-64.zip\"],\"otherPatchFileNames\": [\"p29213893_1910000DBRU_Generic.zip\",\"p29782284_1910000DBRU_Generic.zip\",\"p28730253_190000_Linux-x86-64.zip\",\"p29374604_1910000DBRU_Linux-x86-64.zip\",\"p28852325_190000_Linux-x86-64.zip\",\"p29997937_190000_Linux-x86-64.zip\",\"p31335037_190000_Linux-x86-64.zip\",\"p31335142_190000_Generic.zip\"]\"installationParameters\":{ \"unixGroupName\":\"dba\", \ \"unixUname\":\"oracle\", \ \"oracleHome\":\"/home/oracle/oracle.19.0.0.0.ru-2020-04.rur-2020-04.r1.EE.1\", \ \"oracleBase\":\"/home/oracle/\"}}"`
+ `--database-installation-files-s3-bucket-name` : spécifiez le même nom de compartiment que celui que vous avez indiqué dans [Étape 3 : Charger vos fichiers d'installation dans Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3). La Région AWS dans laquelle vous exécutez `create-custom-db-engine-version` doit être dans la même région que votre compartiment Amazon S3.
Vous pouvez également spécifier les options suivantes :
+ `--description` : spécifiez une description de votre CEV.
+ `--database-installation-files-s3-prefix` : spécifiez le nom de dossier que celui que vous avez indiqué dans [Étape 3 : Charger vos fichiers d'installation dans Amazon S3](custom-cev.preparing.md#custom-cev.preparing.s3).
+ `--image-id` : spécifiez un ID d'AMI que vous souhaitez réutiliser. Pour trouver des ID valides, exécutez la commande `describe-db-engine-versions`, puis recherchez la sortie pour `ImageID`. Par défaut, RDS Custom for Oracle utilise l'AMI disponible la plus récente.
L'exemple suivant crée un CEV multi-locataire Oracle nommé `19.cdb_cev1`. L'exemple réutilise une AMI existante plutôt que d'utiliser la dernière AMI disponible. Assurez-vous que le nom de votre CEV commence par le numéro de version du moteur principal.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds create-custom-db-engine-version \
2. --engine custom-oracle-se2-cdb \
3. --engine-version 19.cdb_cev1 \
4. --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files \
5. --database-installation-files-s3-prefix 123456789012/cev1 \
6. --kms-key-id my-kms-key \
7. --description "test cev" \
8. --manifest manifest_string \
9. --image-id ami-012a345678901bcde
```
Pour Windows :
```
1. aws rds create-custom-db-engine-version ^
2. --engine custom-oracle-se2-cdb ^
3. --engine-version 19.cdb_cev1 ^
4. --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files ^
5. --database-installation-files-s3-prefix 123456789012/cev1 ^
6. --kms-key-id my-kms-key ^
7. --description "test cev" ^
8. --manifest manifest_string ^
9. --image-id ami-012a345678901bcde
```
**Example**
Obtenez des détails sur votre CEV en utilisant la commande `describe-db-engine-versions`.
```
1. aws rds describe-db-engine-versions \
2. --engine custom-oracle-se2-cdb \
3. --include-all
```
L'exemple de sortie partielle suivant affiche le moteur, les groupes de paramètres, le manifeste et d'autres informations.
```
1. {
2. "DBEngineVersions": [
3. {
4. "Engine": "custom-oracle-se2-cdb",
5. "EngineVersion": "19.cdb_cev1",
6. "DBParameterGroupFamily": "custom-oracle-se2-cdb-19",
7. "DBEngineDescription": "Containerized Database for Oracle Custom SE2",
8. "DBEngineVersionDescription": "test cev",
9. "Image": {
10. "ImageId": "ami-012a345678901bcde",
11. "Status": "active"
12. },
13. "ValidUpgradeTarget": [],
14. "SupportsLogExportsToCloudwatchLogs": false,
15. "SupportsReadReplica": true,
16. "SupportedFeatureNames": [],
17. "Status": "available",
18. "SupportsParallelQuery": false,
19. "SupportsGlobalDatabases": false,
20. "MajorEngineVersion": "19",
21. "DatabaseInstallationFilesS3BucketName": "us-east-1-123456789012-custom-installation-files",
22. "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
23. "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:custom-oracle-se2-cdb/19.cdb_cev1/abcd12e3-4f5g-67h8-i9j0-k1234l56m789",
24. "KMSKeyId": "arn:aws:kms:us-east-1:732027699161:key/1ab2345c-6d78-9ef0-1gh2-3456i7j89k01",
25. "CreateTime": "2023-03-07T19:47:58.131000+00:00",
26. "TagList": [],
27. "SupportsBabelfish": false,
28. ...
```
## Échec de la création d'une CEV
Si la création d'une CEV échoue, RDS Custom émet `RDS-EVENT-0198` avec le message `Creation failed for custom engine version major-engine-version.cev_name` et ajoute des détails sur l'échec. Par exemple, l'événement imprime les fichiers manquants.
Vous ne pouvez pas modifier une CEV qui a échoué. Vous pouvez seulement la supprimer, puis réessayer de créer une CEV après avoir corrigé les causes de l'échec. Pour plus d'informations concernant le dépannage des raisons de l'échec de création de CEV, voir [Résolution des problèmes liés à la création d'une version de moteur personnalisée pour RDS Custom for Oracle](custom-troubleshooting.md#custom-troubleshooting.cev).