Mapper les domaines personnalisés

App Engine permet de diffuser des applications via un domaine personnalisé, tel que example.com, plutôt qu'avec l'adresse appspot.com par défaut. Vous pouvez créer un mappage de domaine de sorte que votre application App Engine utilise un domaine personnalisé.

Par défaut, lorsque vous mappez un domaine personnalisé avec votre application, App Engine émet un certificat géré pour SSL pour les connexions HTTPS. Pour plus d'informations sur l'utilisation du protocole SSL avec un domaine personnalisé, par exemple concernant l'emploi de vos propres certificats SSL, consultez la page Sécuriser les domaines personnalisés avec SSL.

Grâce à cette page, apprenez à créer un mappage de domaine pour votre application s'exécutant sur App Engine.

L'emploi de domaines personnalisés dans les régions suivantes peut sensiblement augmenter la latence des réponses : northamerica-northeast1 (Montréal), southamerica-east1 (São Paulo), asia-south1 (Mumbai) et australia-southeast1 (Sydney).

Avant de commencer

  1. Achetez un nouveau domaine, à moins que vous ne souhaitiez en utiliser un que vous possédez déjà. (vous pouvez utiliser n'importe quel service d'enregistrement de noms de domaine, y compris Google Domains)

  2. Si vous choisissez d'exécuter les commandes de l'outil gcloud, procédez comme suit :

    1. Installez et initialisez le SDK Cloud :

      Télécharger et installer

  3. Si vous choisissez d'utiliser l'API Admin, consultez les conditions requises indiquées sur la page Accéder à l'API Admin.

Ajouter un domaine personnalisé pour votre application

Si vous souhaitez ajouter un domaine personnalisé pour votre application App Engine :

  1. Confirmez que vous êtes bien le propriétaire du domaine via le Centre pour les webmasters :

    Console
    1. Dans la console Google Cloud Platform, accédez à App Engine > Paramètres > Domaines personnalisés :

      Accéder à la page "Domaines personnalisés"

    2. Cliquez sur Ajouter un domaine personnalisé pour afficher le formulaire Add a new custom domain (Ajouter un nom de domaine personnalisé) :

      Ajouter un domaine personnalisé

    3. Dans la section Select the domain you want to use (Sélectionner le domaine à utiliser), saisissez le nom du domaine que vous voulez utiliser, par exemple example.com, puis cliquez sur Continuer pour ouvrir la page Centre pour les webmasters dans un nouvel onglet :
      1. Validez la propriété du domaine à l'aide du Centre pour les webmasters.

        Important : La validation de la propriété du domaine à l'aide d'un enregistrement CNAME est l'option à privilégier pour App Engine. Si vous choisissez d'employer un enregistrement TXT, vous devez éviter de configurer le système de noms de domaine (DNS, Domain Name System) de votre domaine avec un enregistrement CNAME. En effet, l'enregistrement CNAME remplace l'enregistrement TXT et fait que le domaine n'est pas vérifié.

        Si les méthodes de validation du domaine n'offrent pas l'option d'enregistrement CNAME, vous pouvez sélectionner Autre en tant que fournisseur de domaine, puis choisir Ajouter un enregistrement CNAME :

        1. Cliquez sur Autres méthodes, puis sur Fournisseur de nom de domaine.
        2. Dans le menu, sélectionnez Autre.
        3. Dans la section Having trouble (Vous rencontrez des problèmes ?), cliquez sur Ajouter un enregistrement CNAME, puis suivez les instructions pour valider la propriété du domaine.

          N'oubliez pas : la définition du CNAME auprès du service d'enregistrement de noms de domaine peut prendre une minute.

      2. Revenez au formulaire Add a new custom domain (Ajouter un nom de domaine personnalisé) dans la console GCP.
    gcloud
    1. Exécutez la commande suivante gcloud domains pour ouvrir la page Centre pour les webmasters :

      gcloud domains verify DOMAIN

      DOMAIN est le domaine dont vous souhaitez valider la propriété.

      Exemple :

      gcloud domains verify example.com
    2. Validez la propriété du domaine à l'aide du Centre pour les webmasters.

      Important : La validation de la propriété du domaine à l'aide d'un enregistrement CNAME est l'option à privilégier pour App Engine. Si vous choisissez d'employer un enregistrement TXT, vous devez éviter de configurer le système de noms de domaine (DNS, Domain Name System) de votre domaine avec un enregistrement CNAME. En effet, l'enregistrement CNAME remplace l'enregistrement TXT et fait que le domaine n'est pas vérifié.

      Si les méthodes de validation du domaine n'offrent pas l'option d'enregistrement CNAME, vous pouvez sélectionner Autre en tant que fournisseur de domaine, puis choisir Ajouter un enregistrement CNAME :

      1. Cliquez sur Autres méthodes, puis sur Fournisseur de nom de domaine.
      2. Dans le menu, sélectionnez Autre.
      3. Dans la section Having trouble (Vous rencontrez des problèmes ?), cliquez sur Ajouter un enregistrement CNAME, puis suivez les instructions pour valider la propriété du domaine.

        N'oubliez pas : la définition du CNAME auprès du service d'enregistrement de noms de domaine peut prendre une minute.

      Exemple
      Pour ajouter l'enregistrement CNAME suivant à la configuration DNS de votre domaine, procédez comme suit :
      CNAME Label / Host: a1b2c3d4e5.example.com.
      CNAME Destination / Target: gv-abcdefghijk.dv.googlehosted.com
      Mappez les valeurs Label / Host et Destination / Target sur les champs correspondants de la configuration DNS du domaine. Par exemple, dans Google Domains, définissez le CNAME comme suit :
      NOMTYPETTLDONNÉES
      a1b2c3d4e5CNAME1 hgv-abcdefghijk.dv.googlehosted.com.

      Pour obtenir plus d'informations sur l'ajout d'un enregistrement CNAME, y compris des instructions propres aux domaines, consultez la page d'assistance.

  2. Assurez-vous que votre domaine a été validé, sinon vous ne pourrez pas effectuer les étapes suivantes. Notez que seuls les domaines validés seront affichés.

    Console

    Si votre domaine ne figure pas encore dans la liste, cliquez sur Actualiser les domaines.

    gcloud

    Exécutez la commande gcloud domains suivante pour répertorier les domaines validés :

    gcloud domains list-user-verified

  3. Si vous devez déléguer la propriété de votre domaine à d'autres utilisateurs ou comptes de service, vous pouvez ajouter une autorisation via la page Centre pour les webmasters :

    1. Ouvrez l'adresse suivante dans votre navigateur Web :

      https://www.google.com/webmasters/verification/home

    2. Dans Propriétés, cliquez sur le domaine pour lequel vous souhaitez ajouter un utilisateur ou un compte de service.

    3. Faites défiler la page jusqu'à la liste Verified owners (Propriétaires validés), cliquez sur Add an owner (Ajouter un propriétaire), puis saisissez l'adresse e-mail du compte Google ou l'ID du compte de service.

      Pour afficher la liste de vos comptes de service, ouvrez la page "Comptes de service" dans la console GCP :

      Accéder à la page "Comptes de service"

  4. Une fois que vous avez validé la propriété de votre domaine, vous pouvez le mapper sur votre application App Engine :

    Console

    Passez à l'étape suivante du formulaire Add a new custom domain (Ajouter un nom de domaine personnalisé) pour sélectionner le domaine que vous souhaitez mapper avec l'application App Engine :

    1. Spécifiez le domaine et les sous-domaines que vous voulez mapper. Le domaine nu et le sous-domaine www sont pré-remplis dans le formulaire.
      • Un domaine nu, tel que example.com, est mappé sur http://example.com.
      • Un sous-domaine, tel que www, est mappé sur http://www.example.com.
    2. Cliquez sur Enregistrer les mappages pour créer le mappage souhaité.
    3. Dans la dernière étape du formulaire Add a new custom domain (Ajouter un nom de domaine personnalisé), notez les enregistrements de ressources répertoriés, y compris leur type et leur nom canonique (CNAME), car vous devrez ajouter ces détails à la configuration DNS du domaine.

      Dans l'exemple ci-dessous, CNAME est l'un des types répertoriés et ghs.googlehosted.com est son nom canonique.

      Ajouter un domaine personnalisé
    gcloud

    Exécutez la commande gcloud app domain-mappings suivante pour mapper votre domaine sur l'application App Engine :

    gcloud app domain-mappings create DOMAIN
    • DOMAIN est le domaine que vous souhaitez mapper sur l'application App Engine, par exemple *.example.com.
    • Si vous obtenez une erreur, essayez de placer des guillemets autour du domaine comme suit : '*.example.com'.

      Exemple :

      gcloud app domain-mappings create '*.example.com'
    • Notez les enregistrements de ressources qui sont maintenant répertoriés, y compris leur type et leur nom canonique (CNAME), car vous devrez ajouter ces détails à la configuration DNS du domaine.
    API

    Pour mapper par programmation votre domaine sur votre application App Engine, consultez la méthode app.domainMappings.create de l' API Admin.

    Une fois le domaine mappé avec l'application App Engine, répertoriez vos enregistrements de ressources à l'aide de la méthode apps.domainMappings.list .

  5. Ajoutez les enregistrements de ressources que vous recevez à la configuration DNS de votre service d'enregistrement de noms de domaine :

    1. Connectez-vous à votre compte auprès du service d'enregistrement de noms de domaine, puis ouvrez la page de configuration DNS.

    2. Recherchez la section relative aux enregistrements d'hôtes sur la page de configuration du domaine, puis ajoutez chacun des enregistrements de ressources que vous avez reçus lorsque vous avez mappé le domaine sur l'application App Engine.

      En règle générale, le nom d'hôte est répertorié avec le nom canonique en tant qu'adresse. Par exemple, si vous avez enregistré un domaine Google, l'un des enregistrements que vous ajoutez à votre configuration DNS est le nom d'hôte www avec l'adresse ghs.googlehosted.com. Pour spécifier un domaine nu, utilisez plutôt @ avec l'adresse ghs.googlehosted.com.

      Si vous effectuez une migration depuis un autre fournisseur, assurez-vous que tous les enregistrements DNS pointent vers votre application App Engine.

      Pour en savoir plus sur le mappage du domaine, consultez les sections Utiliser des sous-domaines et Mappages à partir de caractères génériques ci-après.

    3. Enregistrez vos modifications dans la page de configuration DNS du compte de votre domaine. Notez qu'un certain délai est nécessaire avant que ces changements ne prennent effet.

  6. Testez vos modifications en accédant à votre application via sa nouvelle URL de domaine, par exemple www.example.com.

Utiliser des sous-domaines

Si vous configurez un mappage de sous-domaine à partir de caractères génériques pour votre domaine personnalisé, votre application diffuse les requêtes de tout sous-domaine correspondant.

  • Si l'utilisateur parcourt un domaine qui correspond à un nom de version d'application ou à un nom de service, l'application diffuse cette version.
  • Si l'utilisateur parcourt un domaine qui correspond à un nom de service, l'application diffuse ce service.
  • Le nombre de certificats SSL gérés par semaine pour chaque domaine de base est limité à 20. Si vous atteignez cette limite, App Engine continue d'essayer d'émettre des certificats gérés jusqu'à ce que toutes les requêtes aient été traitées.

Mappages à partir de caractères génériques

Vous pouvez utiliser des caractères génériques pour mapper des sous-domaines à tout niveau, à compter des sous-domaines de troisième niveau. Par exemple, si votre domaine est example.com et que vous saisissez du texte dans le champ d'adresse Web :

  • la saisie de *.example.com mappe tous les sous-domaines de example.com sur votre application ;
  • la saisie de *.private.example.com mappe tous les sous-domaines de private.example.com sur votre application ;
  • la saisie de *.nichol.sharks.nhl.example.com mappe tous les sous-domaines de nichol.sharks.nhl.example.com sur votre application ;
  • la saisie de *.excogitate.system.example.com mappe tous les sous-domaines de excogitate.system.example.com sur votre application.

Vous pouvez utiliser des mappages à partir de caractères génériques avec des services dans App Engine en définissant le routage des requêtes vers des services spécifiques à l'aide du fichier dispatch.yaml.

Si vous utilisez G Suite avec d'autres sous-domaines de votre domaine, tels que sites et mail, ces mappages ont une priorité supérieure et sont mis en correspondance en premier, avant tout mappage à partir de caractères génériques. En outre, si d'autres applications App Engine vous appartenant sont mappées sur d'autres sous-domaines, ces mappages possèdent également une priorité plus élevée que tout mappage à partir de caractères génériques.

Certains fournisseurs DNS peuvent ne pas fonctionner avec le mappage de sous-domaine à partir de caractères génériques. En particulier, un fournisseur DNS doit autoriser les caractères génériques dans les entrées d'hôte CNAME.

Les règles de routage générique s'appliquent aux URL contenant des composants de services, versions et instances, conformément aux règles de routage de service pour App Engine.

Étape suivante

Sécurisez vos domaines personnalisés avec SSL.

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Environnement standard App Engine pour Python