Etape 1: Mise à disposition via la console

1. Connectez-vous à la console Web IBM Cloud.

2. Cliquez sur le service Databases for PostgreSQL dans le catalogue.

3. Dans les détails du service, configurez les éléments suivants :

   • Nom du service: ce nom peut être n'importe quelle chaîne de caractères; il s'agit du nom utilisé sur le Web et dans l'interface de ligne de commande (CLI) pour identifier le nouveau déploiement.
   • Groupe de ressources: si vous organisez vos services en groupes de ressources, indiquez le groupe de ressources dans ce champ. Sinon, vous pouvez conserver le nom par défaut. Pour plus d'informations, voir Gestion des groupes de ressources.
   • Emplacement- La région du cloud public du déploiement.

4. Allocation de ressources-Spécifiez la mémoire RAM, le disque et les coeurs initiaux pour vos bases de données. Les tailles minimales de mémoire et de disque sont sélectionnées par défaut. Avec des cœurs dédiés, votre groupe de ressources se voit doter d'un hôte à un seul titulaire avec une réserve minimum de partages d'UC. Le nombre de cœurs que vous spécifiez est alors attribué à vos déploiements. Une fois mis à disposition, le disque ne peut pas être réduit.

5. Dans la configuration du service, configurez les éléments suivants :

   • Version de la base de données Set only at deployment- La version de déploiement de votre base de données. Pour garantir des performances optimales, exécutez la version préférée. La dernière version mineure est utilisée automatiquement. Pour plus d'informations, consultez la politique de gestion des versions des bases de données.
   • Chiffrement-Si vous utilisez Key Protect, une instance et une clé peuvent être sélectionnées pour chiffrer le disque du déploiement. Si vous n'utilisez pas votre propre clé, le déploiement crée et gère automatiquement sa propre clé de chiffrement de disque.
   • Points de terminaison Set only at deployment- Configurez lespoints de terminaison du service sur votre déploiement.

   Une fois les paramètres appropriés configurés, cliquez sur Créer pour lancer le processus de provisionnement. La page Liste de ressources Databases for PostgreSQL s'ouvre.

6. Cliquez sur Créer. La page Cloud Databases Liste de ressources s'ouvre.

7. Lorsque votre instance est provisionnée, cliquez sur le nom de l'instance pour afficher plus d'informations.

Etape 1: Mise à disposition via l'interface de ligne de commande

Vous pouvez mettre à disposition une instance Databases for PostgreSQL via l'interface de ligne de commande. Si vous ne l'avez pas déjà, vous devez installer l'interface de ligne de commande IBM Cloud.

1. Connectez-vous à IBM Cloud à l'aide de la commande suivante :

   ibmcloud login
   

   Si vous utilisez un identifiant utilisateur fédéré, il est important que vous passiez à un code d'accès à usage unique (ibmcloud login --sso), ou que vous utilisiez une clé API (ibmcloud --apikey key ou @key_file) pour vous authentifier. Pour plus d'informations sur la connexion via l'interface de ligne de commande (CLI), consultez la section Commandes générales de la CLI(ibmcloud) sous ibmcloud login.

2. Créer une instance Databases for PostgreSQL.

   Sélectionnez l'une des méthodes suivantes :

   • Pour créer une instance à partir de l'interface de ligne de commande sur le plan Enterprise, exécutez la commande suivante :

       ibmcloud resource service-instance-create <INSTANCE_NAME> <SERVICE_NAME> <SERVICE_PLAN_NAME> <LOCATION> <SERVICE_ENDPOINTS_TYPE> <RESOURCE_GROUP>
       ```
   Les zones de la commande sont décrites dans le tableau qui suit.
   
   | Zone | Description | Indicateur |
   |-------|------------|------------|
   | `NAME` [Required]{: tag-red} | Le nom de l'instance peut être n'importe quelle chaîne de caractères; il s'agit du nom utilisé sur le Web et dans l'interface de ligne de commande (CLI) pour identifier le nouveau déploiement. |  |
   | `SERVICE_NAME` [Required]{: tag-red} | Nom ou ID du service. Pour Databases for PostgreSQL, utilisez `databases-for-postgresql`. |  |
   | `SERVICE_PLAN_NAME` [Required]{: tag-red} | Plan standard (`standard`) |  |
   | `LOCATION` [Required]{: tag-red} | L'emplacement où vous souhaitez effectuer le déploiement. Pour obtenir une liste des régions, utilisez la commande `ibmcloud regions`. |  |
   | `SERVICE_ENDPOINTS_TYPE` | Configurez les [points de terminaison de service](/docs/cloud-databases?topic=cloud-databases-service-endpoints) de votre déploiement, soit `public` ou `private`. |  |
   | `RESOURCE_GROUP` | Le nom du groupe de ressources.  La valeur par défaut est `default`. | -g |
   | `--parameters` | Fichier JSON ou chaînes de paramètres JSON pour la création de l'instance de service | -p |
   {: caption="Champs du format de base de la commande" caption-side="top"}
   
   Vous voyez s'afficher une réponse du type :
   
   ```text {: codeblock}
   Creating service instance INSTANCE_NAME in resource group default of account    USER...
   OK
   Service instance INSTANCE_NAME was created.
   Name:                INSTANCE_NAME
   ID:                  crn:v1:bluemix:public:databases-for-postgresql:us-east:a/   40ddc34a846383BGB5b60e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                dd13152c-fe15-4bb6-af94-fde0af56897
   Location:            LOCATION
   State:               provisioning
   Type:                service_instance
   Sub Type:            Public
   Service Endpoints:   private
   Allow Cleanup:       false
   Locked:              false
   Created at:          2023-06-26T19:42:07Z
   Updated at:          2023-06-26T19:42:07Z
   Last Operation:
                       Status    create in progress
                       Message   Started create instance operation
   

3. Pour vérifier l'état du provisionnement, utilisez la commande suivante :

   ibmcloud resource service-instance <INSTANCE_NAME>
   

   Lorsque vous avez terminé, vous voyez une réponse du type:

   Retrieving service instance INSTANCE_NAME in resource group default under account USER's Account as USER...
   OK
   Name:                  INSTANCE_NAME
   ID:                    crn:v1:bluemix:public:databases-for-postgresql:us-east:a/40ddc34a953a8c02f109835656860e:dd13152c-fe15-4bb6-af94-fde0af5303f4::
   GUID:                  dd13152c-fe15-4bb6-af94-fde5654765
   Location:              <LOCATION>
   Service Name:          databases-for-postgresql
   Service Plan Name:     standard
   Resource Group Name:   default
   State:                 active
   Type:                  service_instance
   Sub Type:              Public
   Locked:                false
   Service Endpoints:     private
   Created at:            2023-06-26T19:42:07Z
   Created by:            USER
   Updated at:            2023-06-26T19:53:25Z
   Last Operation:
                          Status    create succeeded
                          Message   Provisioning PostgreSQL with version 12 (100%)
   

4. (Facultatif) Suppression d'une instance de service Pour supprimer une instance, exécutez une commande comme celle-ci :

   ibmcloud resource service-instance-delete <INSTANCE_NAME>
   

ibmcloud cdb deployment-connections example-postgres --start

ibmcloud resource service-instance-create databases-for-postgresql <SERVICE_NAME> standard us-south \
-p \ '{
  "backup_id": "crn:v1:blue:public:databases-for-postgresql:us-south:a/54e8ffe85dcedf470db5b5ee6ac4a8d8:1b8f53db-fc2d-4e24-8470-f82b15c71717:backup:06392e97-df90-46d8-98e8-cb67e9e0a8e6",
  "members_memory_allocation_mb": "3072"
}'

Etape 1: Mise à disposition via l'API du contrôleur de ressources

Procédez comme suit pour mettre à disposition à l'aide de l'API de contrôleur de ressources.

1. Obtenez un jeton IAM à partir de votre jeton API.

2. Vous devez connaître l'ID du groupe de ressources dans lequel vous souhaitez effectuer le déploiement. Ces informations sont disponibles via l'interface de ligne de commande IBM Cloud.

   Utilisez une commande telle que:

   ibmcloud resource groups
   

3. Vous devez connaître la région dans laquelle vous souhaitez effectuer le déploiement.

   Pour répertorier toutes les régions dans lesquelles les déploiements peuvent être mis à disposition à partir de la région en cours, utilisez le plug-in d'interface de ligne de commandeCloud Databases.

   La commande se présente comme suit:

   ibmcloud cdb regions --json
   

   Une fois que vous disposez de toutes les informations, mettez à disposition une nouvelle instance de ressource avec le contrôleur de ressources IBM Cloud.

   curl -X POST \
     https://resource-controller.cloud.ibm.com/v2/resource_instances \
     -H 'Authorization: Bearer <>' \
     -H 'Content-Type: application/json' \
       -d '{
       "name": "my-instance",
       "target": "blue-us-south",
       "resource_group": "5g9f447903254bb58972a2f3f5a4c711",
       "resource_plan_id": "databases-for-postgresql-standard"
     }'
   

   Les paramètres name, target, resource_group et resource_plan_id sont tous obligatoires.

Liste des paramètres supplémentaires

• backup_id- CRN d'une ressource de sauvegarde à partir de laquelle on peut restaurer. La sauvegarde doit être créée par un déploiement de base de données portant le même identifiant de service. La sauvegarde est chargée après la mise à disposition et le nouveau déploiement démarre et utilise ces données. Un CRN de sauvegarde a le format crn:v1:<...>:backup:<uuid>. S'il est omis, la base de données est mise à disposition vide.

• version - Version de la base de données à mettre à disposition. S'il est omis, la base de données est créée avec la version majeure et la version mineure la plus récente.

• disk_encryption_key_crn- Le CRN d’une clé KMS ( Key Protect ), qui est ensuite utilisé pour le chiffrement du disque. Le CRN d'une clé KMS se présente sous la forme crn:v1:<...>:key:<id>.

• backup_encryption_key_crn- Le CRN d'une clé KMS (par exemple, [Key Protect ), qui est ensuite utilisée pour le cryptage des sauvegardes. Le CRN d'une clé KMS se présente sous la forme crn:v1:<...>:key:<id>.

  Pour utiliser une clé pour vos sauvegardes, vous devez d'abord activer la délégation de service à service.

• members_memory_allocation_mb - Quantité totale de mémoire à partager entre les membres de la base de données au sein de la base de données. Par exemple, si la valeur est "6144", et qu'il y a trois membres de la base de données, alors le déploiement obtient 6 Go de RAM au total, ce qui donne 2 Go de RAM par membre. En cas d'omission, la valeur par défaut pour le type de base de données est utilisée.

• members_disk_allocation_mb - Quantité totale de disque à partager entre les membres de la base de données au sein de la base de données. Par exemple, si la valeur est "30720", et qu'il y a trois membres, alors le déploiement obtient 30 Go de disque au total, ce qui donne 10 Go de disque par membre. En cas d'omission, la valeur par défaut pour le type de base de données est utilisée.

• members_cpu_allocation_count - Permet et attribue le nombre de coeurs dédiés spécifiés à votre déploiement. Par exemple, pour utiliser deux coeurs dédiés par membre, utilisez "members_cpu_allocation_count":"2". En cas d'omission, la valeur par défaut "Shared CPU" utilise les ressources de traitement sur les hôtes partagés.

• service_endpoints- Les points de terminaison du service pris en charge dans votre déploiement, public ou private. Il s'agit d'un paramètre obligatoire.

Etape 1: Mise à disposition via Terraform

Utilisez Terraform pour gérer votre infrastructure via ibm_database Resource for Terraform. Vous pouvez également utiliser les modules Terraform IBM pour gérer votre infrastructure via les modules Terraform IBM pour Databases for PostgreSQL.

Etape 5: Connecter IBM Cloud Monitoring via la console

Vous pouvez utiliser IBM Cloud Monitoring pour obtenir une visibilité opérationnelle sur les performances et la santé de vos applications, services et plateformes. IBM Cloud Monitoring fournit aux administrateurs, aux équipes DevOps et aux développeurs une télémétrie de pile complète avec des fonctions avancées pour surveiller et traiter les incidents, définir des alertes et concevoir des tableaux de bord personnalisés.

Pour plus d'informations sur l'utilisation de Monitoring avec Databases for PostgreSQL, voir Intégration de la surveillance.

Etape 5: Connexion de IBM Cloud Monitoring via l'interface de ligne de commande

Vous pouvez utiliser IBM Cloud Monitoring pour obtenir une visibilité opérationnelle sur les performances et la santé de vos applications, services et plateformes. IBM Cloud Monitoring fournit aux administrateurs, aux équipes DevOps et aux développeurs une télémétrie de pile complète avec des fonctions avancées pour surveiller et traiter les incidents, définir des alertes et concevoir des tableaux de bord personnalisés.

Pour plus d'informations sur l'utilisation de Monitoring avec Databases for PostgreSQL, voir Intégration de la surveillance.

Vous ne pouvez pas vous connecter à IBM Cloud Monitoring en utilisant le CLI. Utilisez la console pour effectuer cette tâche. Pour plus d'informations, voir Surveillance de l'intégration.

Etape 5: Connexion de IBM Cloud Monitoring via l'API

Vous pouvez utiliser IBM Cloud Monitoring pour obtenir une visibilité opérationnelle sur les performances et la santé de vos applications, services et plateformes. IBM Cloud Monitoring fournit aux administrateurs, aux équipes DevOps et aux développeurs une télémétrie de pile complète avec des fonctions avancées pour surveiller et traiter les incidents, définir des alertes et concevoir des tableaux de bord personnalisés.

Pour plus d'informations sur l'utilisation de Monitoring avec Databases for PostgreSQL, voir Intégration de la surveillance.

Vous ne pouvez pas vous connecter à IBM Cloud Monitoring en utilisant le CLI. Utilisez la console pour effectuer cette tâche. Pour plus d'informations, voir Surveillance de l'intégration.

Etape 5: Connecter IBM Cloud Monitoring via Terraform

Vous pouvez utiliser IBM Cloud Monitoring pour obtenir une visibilité opérationnelle sur les performances et la santé de vos applications, services et plateformes. IBM Cloud Monitoring fournit aux administrateurs, aux équipes DevOps et aux développeurs une télémétrie de pile complète avec des fonctions avancées pour surveiller et traiter les incidents, définir des alertes et concevoir des tableaux de bord personnalisés.

Pour plus d'informations sur l'utilisation de Monitoring avec Databases for PostgreSQL, voir Intégration de la surveillance.

Vous ne pouvez pas vous connecter à IBM Cloud Monitoring en utilisant le CLI. Utilisez la console pour effectuer cette tâche. Pour plus d'informations, voir Surveillance de l'intégration.

Étape 6 : Connexion IBM Cloud Activity Tracker Event Routing

IBM Cloud® Activity Tracker Event Routing vous permet de visualiser, de gérer et d'auditer l'activité des services afin de respecter les politiques de l'entreprise et les réglementations sectorielles. Activity Tracker Event Routing enregistre les activités initiées par l'utilisateur qui modifient l'état d'un service dans IBM Cloud. Utilisez Activity Tracker Event Routing pour suivre la manière dont les utilisateurs et les applications interagissent avec le service Databases for PostgreSQL.

Pour commencer à utiliser Activity Tracker Event Routing, voir Démarrer avec IBM Cloud® Activity Tracker Event Routing.

Activity Tracker Event Routing ne peut posséder qu'une seule instance par emplacement. Pour afficher des événements, vous devez accéder à l'interface Web du service IBM Cloud® Activity Tracker Event Routing au même emplacement que celui où votre instance de service est disponible.

Pour plus d'informations sur les événements spécifiques à Databases for PostgreSQL, voir Événements de suivi d'activité.

Les événements sont formatés conformément à la norme CADF (Cloud Auditing Data Federation). Pour plus de détails sur les informations qu'ils incluent, voir la norme CADF.

Étape 6 : Connecter IBM Cloud Activity Tracker Event Routing via le CLI

IBM Cloud® Activity Tracker Event Routing vous permet de visualiser, de gérer et d'auditer l'activité des services afin de respecter les politiques de l'entreprise et les réglementations sectorielles. Activity Tracker Event Routing enregistre les activités initiées par l'utilisateur qui modifient l'état d'un service dans IBM Cloud. Utilisez Activity Tracker Event Routing pour suivre la manière dont les utilisateurs et les applications interagissent avec le service Databases for PostgreSQL.

Pour commencer à travailler avec Activity Tracker Event Routing, voir la section "Getting Started with Activity Tracker Event Routing " (Démarrer avec ).

Activity Tracker Event Routing ne peut posséder qu'une seule instance par emplacement. Pour afficher des événements, vous devez accéder à l'interface Web du service Activity Tracker Event Routing au même emplacement que celui où votre instance de service est disponible. Pour plus d'informations, voir Lancement de l'interface utilisateur Web.

Pour plus d'informations sur les événements spécifiques à Databases for PostgreSQL, voir Événements de suivi d'activité.

Les événements sont formatés conformément à la norme CADF (Cloud Auditing Data Federation). Pour plus de détails sur les informations qu'ils incluent, voir la norme CADF.

Vous ne pouvez pas vous connecter à Activity Tracker Event Routing en utilisant le CLI. Utilisez la console pour effectuer cette tâche. Pour plus d'informations, voir Événements de suivi d'activité.

Étape 6 : Connecter IBM Cloud® Activity Tracker Event Routing via l'API

IBM Cloud Activity Tracker Event Routing vous permet de visualiser, de gérer et d'auditer l'activité des services afin de respecter les politiques de l'entreprise et les réglementations sectorielles. Activity Tracker Event Routing enregistre les activités initiées par l'utilisateur qui modifient l'état d'un service dans IBM Cloud. Utilisez Activity Tracker Event Routing pour suivre la manière dont les utilisateurs et les applications interagissent avec le service Databases for PostgreSQL.

Pour commencer à utiliser l' Activity Tracker Event Routing, consultez [Getting Started with Activity Tracker Event Routing]/docs/atracker?topic=atracker-getting-started){: external}.

Activity Tracker Event Routing ne peut posséder qu'une seule instance par emplacement. Pour afficher des événements, vous devez accéder à l'interface Web du service Activity Tracker Event Routing au même emplacement que celui où votre instance de service est disponible. Pour plus d'informations, voir Lancement de l'interface utilisateur Web.

Pour plus d'informations sur les événements spécifiques à Databases for PostgreSQL, voir Événements de suivi d'activité.

Les événements sont formatés conformément à la norme CADF (Cloud Auditing Data Federation). Pour plus de détails sur les informations qu'ils incluent, voir la norme CADF.

Vous ne pouvez pas vous connecter à Activity Tracker Event Routing en utilisant l'API. Utilisez la console pour effectuer cette tâche. Pour plus d'informations, voir Événements de suivi d'activité.

Étape 6 : Connecter IBM Cloud Activity Tracker Event Routing via Terraform

IBM Cloud® Activity Tracker Event Routing vous permet de visualiser, de gérer et d'auditer l'activité des services afin de respecter les politiques de l'entreprise et les réglementations sectorielles. Activity Tracker Event Routing enregistre les activités initiées par l'utilisateur qui modifient l'état d'un service dans IBM Cloud. Utilisez Activity Tracker Event Routing pour suivre la manière dont les utilisateurs et les applications interagissent avec le service Databases for PostgreSQL.

Pour commencer à travailler avec Activity Tracker Event Routing, voir la section "Getting Started with Activity Tracker Event Routing " (Démarrer avec ).

Activity Tracker Event Routing ne peut posséder qu'une seule instance par emplacement. Pour afficher des événements, vous devez accéder à l'interface Web du service Activity Tracker Event Routing au même emplacement que celui où votre instance de service est disponible. Pour plus d'informations, voir Lancement de l'interface utilisateur Web.

Pour plus d'informations sur les événements spécifiques à Databases for PostgreSQL, voir Événements de suivi d'activité.

Les événements sont formatés conformément à la norme CADF (Cloud Auditing Data Federation). Pour plus de détails sur les informations qu'ils incluent, voir la norme CADF.

Vous ne pouvez pas vous connecter à Activity Tracker Event Routing en utilisant l'API. Utilisez la console pour effectuer cette tâche. Pour plus d'informations, voir Événements de suivi d'activité.