Création d'une CEV - Amazon Relational Database Service
Échec de la création d'une CEV

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 un CEV en utilisant le AWS Management Console ou le AWS CLI. Spécifiez l'architecture multilocataire ou non multilocataire. Pour plus d’informations, consultez Considérations relatives à l'architecture multilocataire.

En général, la création d'une CEV prend environ deux heures. Une fois la CEV créée, vous pouvez l'utiliser pour créer 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.

Notez les exigences et limites suivantes pour créer un CEV :

  • Le compartiment Amazon S3 contenant vos fichiers d'installation doit être Région AWS identique à celui de votre CEV. Dans le cas contraire, le processus de création échoue.

  • Le nom CEV doit être au formatmajor-engine-version.customized_string, comme dans19.cdb_cev1.

  • Le nom CEV doit contenir de 1 à 50 caractères alphanumériques, des traits de soulignement, des tirets ou des points.

  • Le nom CEV ne peut pas contenir de points consécutifs, comme dans19..cdb_cev1.

Pour créer une CEV

  1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/rds/.

  2. 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.

  3. Choisissez Create custom engine version (Créer une version de moteur personnalisée).

  4. Dans Options de moteur, procédez comme suit :

    1. Pour Engine type (Type de moteur), choisissez Oracle.

    2. Pour les paramètres d'architecture, choisissez éventuellement Architecture multitenant pour créer un CEV multitenant Oracle, qui utilise le moteur de base de données ou. custom-oracle-ee-cdb 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 n'est pas un CDB, qui utilise le moteur ou. custom-oracle-ee 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.

    3. 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.

    4. Pour Version du moteur, choisissez la version majeure du moteur.

  5. 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_cev1.

    2. (Facultatif) Saisissez une description pour votre CEV.

  6. 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 volet 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 le AWS CLI, utilisez la describe-db-engine-versions commande. Recherchez la sortie pour ImageID.

    2. 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. Par exemple, saisissez s3://my-custom-installation-files/123456789012/cev1/.

      Note

      Le compartiment Région AWS dans lequel vous créez le CEV doit se trouver dans la même région que le compartiment S3.

    3. (Créer un nouveau CEV uniquement) Pour Manifeste CEV, saisissez le manifeste JSON que vous avez créé dans Création du CEV manifeste.

  7. Dans la section clé KMS, sélectionnez Enter a key ARN pour répertorier les AWS KMS clés disponibles. Sélectionnez ensuite votre clé KMS dans la liste.

    Une AWS KMS clé est requise pour RDS Custom. Pour plus d’informations, consultez Étape 1 : Créer ou réutiliser une clé de chiffrement symétrique AWS KMS.

  8. (Facultatif) Choisissez Ajouter une nouvelle balise pour créer une paire clé-valeur pour votre CEV.

  9. 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.

Pour créer un CEV à l'aide de AWS CLI, exécutez la commande create-custom-db-engine-version.

Les options suivantes sont requises :

  • --engine— Spécifiez le type de moteur. Pour un CDB, spécifiez custom-oracle-ee-cdb soitcustom-oracle-se2-cdb. Pour un objet autre qu'un CDB, spécifiez soitcustom-oracle-ee. custom-oracle-se2 Vous ne pouvez créer des CDB qu'à partir d'un CEV créé avec custom-oracle-ee-cdb ou. custom-oracle-se2-cdb Vous pouvez créer des fichiers non CDB uniquement à partir d'un CEV créé avec ou. custom-oracle-ee custom-oracle-se2

  • --engine-version : spécifiez la version du moteur. Le format est major-engine-version. chaîne_personnalisée. Le nom CEV doit contenir de 1 à 50 caractères alphanumériques, des traits de soulignement, des tirets ou des points. Le nom CEV ne peut pas contenir de points consécutifs, comme dans19..cdb_cev1.

  • --kms-key-id— Spécifiez un 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 (\).

    L'exemple suivant illustre la manifest_json_string pour 19c à partir de Étape 5 : Préparation du CEV manifeste. 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 nouvelle 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. Le compartiment Région AWS dans lequel vous exécutez create-custom-db-engine-version doit appartenir à 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.

  • --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.

Pour LinuxmacOS, ou Unix :

aws rds create-custom-db-engine-version \
    --engine custom-oracle-se2-cdb \
    --engine-version 19.cdb_cev1 \
    --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files \
    --database-installation-files-s3-prefix 123456789012/cev1 \
    --kms-key-id my-kms-key \
    --description "test cev" \
    --manifest manifest_string \
    --image-id ami-012a345678901bcde

Dans Windows :

aws rds create-custom-db-engine-version ^
    --engine custom-oracle-se2-cdb ^
    --engine-version 19.cdb_cev1 ^
    --database-installation-files-s3-bucket-name us-east-1-123456789012-custom-installation-files ^
    --database-installation-files-s3-prefix 123456789012/cev1 ^
    --kms-key-id my-kms-key ^
    --description "test cev" ^
    --manifest manifest_string ^
    --image-id ami-012a345678901bcde

Obtenez des détails sur votre CEV en utilisant la commande describe-db-engine-versions.

aws rds describe-db-engine-versions \
    --engine custom-oracle-se2-cdb \
    --include-all

L'exemple de sortie partielle suivant affiche le moteur, les groupes de paramètres, le manifeste et d'autres informations.

{
    "DBEngineVersions": [
        {
            "Engine": "custom-oracle-se2-cdb",
            "EngineVersion": "19.cdb_cev1",
            "DBParameterGroupFamily": "custom-oracle-se2-cdb-19",
            "DBEngineDescription": "Containerized Database for Oracle Custom SE2",
            "DBEngineVersionDescription": "test cev",
            "Image": {
                "ImageId": "ami-012a345678901bcde",
                "Status": "active"
            },
            "ValidUpgradeTarget": [],
            "SupportsLogExportsToCloudwatchLogs": false,
            "SupportsReadReplica": true,
            "SupportedFeatureNames": [],
            "Status": "available",
            "SupportsParallelQuery": false,
            "SupportsGlobalDatabases": false,
            "MajorEngineVersion": "19",
            "DatabaseInstallationFilesS3BucketName": "us-east-1-123456789012-custom-installation-files",
            "DatabaseInstallationFilesS3Prefix": "123456789012/cev1",
            "DBEngineVersionArn": "arn:aws:rds:us-east-1:123456789012:cev:custom-oracle-se2-cdb/19.cdb_cev1/abcd12e3-4f5g-67h8-i9j0-k1234l56m789",
            "KMSKeyId": "arn:aws:kms:us-east-1:732027699161:key/1ab2345c-6d78-9ef0-1gh2-3456i7j89k01",
            "CreateTime": "2023-03-07T19:47:58.131000+00:00",
            "TagList": [],
            "SupportsBabelfish": false,
...

É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.