Pour vous connecter à votre instance AlloyDB pour PostgreSQL depuis l'extérieur de votre réseau cloud privé virtuel (VPC) ou pour permettre à votre instance de se connecter à des ressources externes, vous pouvez activer la connectivité par adresse IP publique. AlloyDB est compatible avec les connexions IP publiques entrantes et sortantes :
- Adresse IP publique entrante : attribue une adresse IPv4 publique à votre instance AlloyDB afin que les clients externes puissent s'y connecter. Vous pouvez éventuellement limiter les connexions directes à des adresses IP externes ou des plages CIDR spécifiques, appelées réseaux externes autorisés. Les réseaux externes autorisés ne sont pas requis lorsque vous vous connectez à l'aide des connecteurs de langage AlloyDB ou du proxy d'authentification AlloyDB. Vous ne pouvez pas spécifier de réseau privé en tant que réseau externe autorisé.
- Adresse IP publique sortante : attribue deux adresses IP publiques sortantes statiques à une instance principale ou secondaire afin que votre base de données puisse initier des connexions à des sources externes, par exemple lors d'une migration de base de données.
Créer une instance AlloyDB
Pour créer une instance avec une adresse IP publique, procédez comme suit :
Console
Accédez à la page Clusters.
Cliquez sur un cluster dans la colonne Nom de la ressource.
Sur la page Présentation, accédez à Instances dans votre cluster, puis cliquez sur Créer une instance principale.
Configurez votre instance principale :
- Dans le champ ID de l'instance, saisissez un ID pour votre instance principale.
- Sous Disponibilité zonale, sélectionnez l'une des options suivantes :
- Pour créer une instance de production à haute disponibilité avec basculement automatique, sélectionnez Plusieurs zones (disponibilité élevée).
- Pour créer une instance de base qui n'a pas besoin d'être hautement disponible, sélectionnez Zone unique.
- Sélectionnez un type de machine.
- Sous Connectivité, sélectionnez Activer l'adresse IP publique pour accepter les connexions entrantes.
- Facultatif : pour ajouter une connectivité sortante, sous Adresses IP publiques sortantes, sélectionnez Activer l'adresse IP publique sortante.
- Facultatif : Pour configurer les exigences SSL ou de connecteur sur l'instance, développez Options de configuration avancées, puis procédez comme suit :
- Par défaut, les instances AlloyDB exigent que toutes les connexions utilisent le chiffrement SSL. Pour autoriser les connexions non SSL, décochez la case N'autoriser que les connexions SSL.
- Pour exiger que toutes les connexions de base de données à l'instance utilisent le proxy d'authentification AlloyDB ou les bibliothèques de connecteurs sécurisés fournies par Google, sélectionnez Imposer l'authentification mTLS via des connecteurs AlloyDB.
Facultatif : Pour limiter les connexions directes à des adresses IP spécifiques, ajoutez une liste de plages CIDR séparées par une virgule :
Sous Réseaux externes autorisés, saisissez une liste de plages CIDR séparées par une virgule. Pour chaque plage CIDR, saisissez un bloc CIDR, tel que
64.233.160.0/16. Pour réduire la surface d'attaque potentielle, limitez au maximum la liste des adresses.Vous pouvez également cliquer sur Utiliser mon adresse IP pour qu'AlloyDB renseigne l'adresse IPv4 de la machine cliente à partir de laquelle vous accédez à Google Cloud.
Cliquez sur Créer une instance.
gcloud
Pour utiliser la gcloud CLI, vous pouvez installer et initialiser la Google Cloud CLI, ou utiliser Cloud Shell.
Pour en savoir plus sur la création d'autres types d'instances, consultez Créer une instance de pool de lecture et Créer une instance secondaire.
Utilisez la commande gcloud alloydb instances create pour créer une instance.
gcloud alloydb instances create INSTANCE_ID \
--instance-type=PRIMARY \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--database-flags=password.enforce_complexity=on \
--assign-inbound-public-ip=ASSIGN_IPV4
Remplacez les éléments suivants :
INSTANCE_ID: ID de l'instance que vous créez. Il doit commencer par une lettre minuscule et peut contenir des lettres minuscules, des chiffres et des traits d'union.CPU_COUNT: nombre de processeurs virtuels que vous souhaitez pour l'instance. Les valeurs valides sont les suivantes :2: 2 vCPU, 16 Go de RAM4: 4 vCPU, 32 Go de RAM8: 8 vCPU, 64 Go de RAM16: 16 vCPU, 128 Go de RAM32: 32 vCPU, 256 Go de RAM64: 64 vCPU, 512 Go de RAM96: 96 vCPU, 768 Go de RAM128: 128 vCPU, 864 Go de RAM
REGION_ID: région dans laquelle vous souhaitez placer l'instance.CLUSTER_ID: ID du cluster que vous avez créé précédemment.
Facultatif : Ajoutez des réseaux externes autorisés
Pour limiter les connexions directes à des adresses IP spécifiques, ajoutez une liste de plages CIDR séparées par une virgule :
gcloud alloydb instances create INSTANCE_ID \
--instance-type=PRIMARY \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--database-flags=password.enforce_complexity=on \
--assign-inbound-public-ip=ASSIGN_IPV4 \
--authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2,...
Remplacez les éléments suivants :
CIDR_RANGE: liste de blocs CIDR séparés par une virgule, par exemple64.233.160.0/16. Pour réduire la surface d'attaque potentielle, limitez au maximum la liste des adresses.
Facultatif : Ajouter une connectivité sortante
Ajoutez l'option --outbound-public-ip pour activer les adresses IP publiques sortantes.
Vous ne pouvez activer l'adresse IP publique sortante que pour les instances principales et secondaires.
gcloud alloydb instances create INSTANCE_ID \
--instance-type=PRIMARY \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID \
--database-flags=password.enforce_complexity=on \
--assign-inbound-public-ip=ASSIGN_IPV4 \
--outbound-public-ip
Activer l'adresse IP publique sur une instance
Pour activer la connectivité entrante à l'aide d'une adresse IP publique, procédez comme suit :
Console
Accédez à la page Clusters.
Cliquez sur un cluster dans la colonne Nom de la ressource.
Sur la page Vue d'ensemble qui s'ouvre, accédez à la section Instances dans votre cluster, puis recherchez votre instance principale.
Cliquez sur Actions sur l'instance > Modifier.
Sous Connectivité, cochez la case Activer l'adresse IP publique pour accepter les connexions entrantes.
Facultatif : Pour limiter les connexions directes à des adresses IP spécifiques, sous Réseaux externes autorisés, saisissez une liste de plages CIDR séparées par une virgule.
Pour chaque plage CIDR, saisissez un bloc CIDR, tel que
64.233.160.0/16. Pour réduire la surface d'attaque potentielle, limitez au maximum la liste des adresses.Cliquez sur Mettre à jour l'instance pour enregistrer vos modifications.
gcloud
Pour utiliser la gcloud CLI, vous pouvez installer et initialiser la Google Cloud CLI, ou utiliser Cloud Shell.
Utilisez la commande gcloud alloydb instances update pour activer l'adresse IP publique sur votre instance.
gcloud alloydb instances update INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--database-flags=password.enforce_complexity=on \
--assign-inbound-public-ip=ASSIGN_IPV4
Remplacez les éléments suivants :
INSTANCE_ID: ID de l'instance que vous mettez à jour.CLUSTER_ID: ID du cluster contenant l'instance.REGION_ID: région dans laquelle se trouve le cluster.
Facultatif : Ajoutez des réseaux externes autorisés
Pour limiter les connexions directes à des adresses IP spécifiques, ajoutez une liste de plages CIDR séparées par une virgule :
gcloud alloydb instances update INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--database-flags=password.enforce_complexity=on \
--assign-inbound-public-ip=ASSIGN_IPV4 \
--authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2,...
Remplacez les éléments suivants :
CIDR_RANGE: liste de blocs CIDR séparés par une virgule, par exemple64.233.160.0/16. Pour réduire la surface d'attaque potentielle, limitez au maximum la liste des adresses.
Désactiver l'adresse IP publique sur une instance
Lorsque vous désactivez l'adresse IP publique sur votre instance, AlloyDB supprime l'adresse IP publique de votre instance et efface la liste des réseaux autorisés. Toutes les connexions entrantes vers votre instance échouent. Les réseaux externes autorisés ne peuvent être utilisés qu'avec une adresse IP publique.
Pour désactiver l'adresse IP publique, procédez comme suit :
Console
Accédez à la page Clusters.
Cliquez sur un cluster dans la colonne Nom de la ressource.
Sur la page Vue d'ensemble qui s'ouvre, accédez à la section Instances dans votre cluster, puis recherchez votre instance principale.
Cliquez sur Actions sur l'instance > Modifier.
Sous Connectivité, décochez la case Activer l'adresse IP publique pour arrêter les connexions entrantes.
Facultatif : Sous Réseaux externes autorisés, supprimez les plages CIDR séparées par une virgule.
Cliquez sur Mettre à jour l'instance pour enregistrer vos modifications.
gcloud
Pour utiliser la gcloud CLI, vous pouvez installer et initialiser la Google Cloud CLI, ou utiliser Cloud Shell.
Exécutez la commande gcloud alloydb instances update pour désactiver l'adresse IP publique sur votre instance.
gcloud alloydb instances update INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--assign-inbound-public-ip=NO_PUBLIC_IP
Remplacez les éléments suivants :
INSTANCE_ID: ID de l'instance que vous mettez à jour.CLUSTER_ID: ID du cluster contenant l'instance.REGION_ID: région dans laquelle se trouve le cluster.
Mettre à jour les réseaux externes autorisés pour une instance
Vous pouvez modifier la liste des réseaux externes autorisés sur votre instance à tout moment. L'adresse IP publique doit être activée sur votre instance lorsque vous mettez à jour la liste des réseaux externes autorisés.
Les réseaux externes autorisés ne peuvent pas être ajoutés ni supprimés individuellement, et la liste des réseaux est remplacée chaque fois que la commande de mise à jour de la liste est exécutée. Pour mettre à jour les réseaux externes autorisés sur votre instance, vous devez fournir une liste d'éléments séparés par une virgule de tous les réseaux externes autorisés chaque fois que vous souhaitez ajouter ou supprimer un réseau. Chaque réseau externe autorisé doit être au format CIDR.
Pour mettre à jour la liste des réseaux externes autorisés sur votre instance, procédez comme suit :
Console
Accédez à la page Clusters.
Cliquez sur un cluster dans la colonne Nom de la ressource.
Sur la page Vue d'ensemble qui s'ouvre, accédez à la section Instances dans votre cluster, puis recherchez votre instance principale.
Cliquez sur Actions sur l'instance > Modifier.
Sous Réseaux externes autorisés, saisissez une liste de plages CIDR séparées par une virgule. Pour chaque plage CIDR, saisissez un bloc CIDR, tel que
64.233.160.0/16. Pour réduire la surface d'attaque potentielle, limitez au maximum la liste des adresses.Cliquez sur Mettre à jour l'instance pour enregistrer vos modifications.
gcloud
Pour utiliser la gcloud CLI, vous pouvez installer et initialiser la Google Cloud CLI, ou utiliser Cloud Shell.
Exécutez la commande gcloud alloydb instances update pour mettre à jour les réseaux externes autorisés sur votre instance.
gcloud alloydb instances update INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--authorized-external-networks=CIDR_RANGE1,CIDR_RANGE2,...
Remplacez les éléments suivants :
INSTANCE_ID: ID de l'instance que vous mettez à jour.CLUSTER_ID: ID du cluster contenant l'instance.REGION_ID: région dans laquelle se trouve le cluster.CIDR_RANGE: liste de blocs CIDR séparés par une virgule, par exemple64.233.160.0/16. Pour réduire la surface d'attaque potentielle, limitez au maximum la liste des adresses.
Ajouter une connectivité sortante à une instance
Vous pouvez activer l'adresse IP publique sortante pour établir une connexion entre votre instance AlloyDB et des sources externes. AlloyDB génère deux adresses IP publiques sortantes qui restent cohérentes jusqu'à ce que vous désactiviez la connectivité sortante sur votre instance. Vous ne pouvez activer l'adresse IP publique sortante que pour les instances principales et secondaires.
Pour activer l'adresse IP publique sortante, procédez comme suit :
Console
Accédez à la page Clusters.
Cliquez sur un cluster dans la colonne Nom de la ressource.
Sur la page Présentation qui s'affiche, accédez à la section Instances dans votre cluster, puis recherchez votre instance principale.
Cliquez sur Actions sur l'instance > Modifier.
Sous Connectivité IP publique sortante, cochez la case Activer l'adresse IP publique sortante pour accepter les connexions sortantes.
Cliquez sur Mettre à jour l'instance pour enregistrer vos modifications.
gcloud
Pour utiliser la gcloud CLI, vous pouvez installer et initialiser la Google Cloud CLI, ou utiliser Cloud Shell.
Utilisez la commande gcloud alloydb instances update pour activer l'adresse IP publique sortante sur votre instance.
gcloud alloydb instances update INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID \
--outbound-public-ip
Remplacez les éléments suivants :
INSTANCE_ID: ID de l'instance pour laquelle vous ajoutez une connectivité sortante.CLUSTER_ID: ID du cluster pour lequel vous ajoutez une connectivité sortante.REGION_ID: région où se trouve votre cluster.
Afficher les détails de connectivité d'une instance
Affichez à tout moment la liste des réseaux externes autorisés sur votre instance et l'adresse IP publique attribuée à l'aide de la commande gcloud alloydb instances
describe. Vous pouvez également afficher les adresses IP publiques sortantes si vous avez activé la connectivité sortante sur votre instance.
Pour afficher les détails de la connectivité, procédez comme suit :
Console
Accédez à la page Clusters.
Cliquez sur un cluster dans la colonne Nom de la ressource.
Accédez à la page Connectivité, où vous pouvez afficher des informations sur votre configuration d'adresse IP publique, y compris la Connectivité IP publique et l'Adresse IP publique sortante.
Pour afficher les informations sur votre adresse IP publique, vous pouvez également choisir une instance dans Instances dans votre cluster, puis cliquer sur Afficher la configuration de la connectivité.
gcloud
Pour utiliser la gcloud CLI, vous pouvez installer et initialiser la Google Cloud CLI, ou utiliser Cloud Shell.
gcloud alloydb instances describe INSTANCE_ID \
--cluster=CLUSTER_ID \
--region=REGION_ID
Remplacez les éléments suivants :
INSTANCE_ID: ID de l'instance que vous consultez.CLUSTER_ID: ID du cluster contenant l'instance.REGION_ID: région dans laquelle se trouve le cluster.
Étapes suivantes
- Présentation de la connexion
- Règles d'administration et contraintes personnalisées
- Se connecter à l'aide du proxy d'authentification AlloyDB
- Se connecter à l'aide de connecteurs de langage AlloyDB