Mapper les domaines personnalisés

App Engine permet aux applications d'être diffusées via un domaine personnalisé, tel que example.com, plutôt que par le biais de l'adresse par défaut appspot.com. Vous pouvez créer un mappage de domaine pour l'application App Engine de sorte qu'elle utilise un domaine personnalisé.

Par défaut, lorsque vous mappez votre domaine personnalisé à votre application, App Engine émet un certificat géré SSL pour les connexions HTTPS. Pour en savoir plus sur l'utilisation de SSL avec le domaine personnalisé, y compris sur l'emploi de vos propres certificats SSL, consultez la section Sécuriser vos domaines personnalisés avec SSL.

Utilisez cette page pour apprendre à créer un mappage de domaine pour votre application s'exécutant sur App Engine.

L'utilisation de domaines personnalisés dans les régions suivantes peut augmenter considérablement la latence des réponses :

  • us-west2
  • us-east4
  • northamerica-northeast1
  • southamerica-east1
  • europe-west2
  • europe-west3
  • asia-south1
  • asia-northeast1
  • australia-southeast1

Avant de commencer

  1. Achetez un nouveau domaine, sauf si vous en avez déjà un que vous souhaitez utiliser. Vous pouvez utiliser n'importe quel service d'enregistrement de noms de domaine, y compris Google Domains.

  2. Si vous choisissez d'utiliser les commandes de l'outil gcloud :

    1. Installez et initialisez le SDK Cloud :

      Télécharger et installer

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

Ajouter un domaine personnalisé pour votre application

Pour ajouter un domaine personnalisé à votre application App Engine :

  1. Confirmez que vous êtes 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 Ajouter un nom de domaine personnalisé :

      Ajouter un domaine personnalisé

    3. Dans la section Sélectionner le domaine à utiliser, saisissez le nom du domaine que vous souhaitez utiliser (par exemple, example.com), puis cliquez sur Continuer pour ouvrir la page du Centre pour les webmasters dans un nouvel onglet.
      1. Utilisez le Centre pour les webmasters afin de valider la propriété du domaine.

        Important : La validation de la propriété d'un domaine à l'aide d'un enregistrement CNAME est l'option recommandée pour App Engine. Si vous choisissez d'utiliser un enregistrement TXT, vous devez éviter de configurer les paramètres DNS du domaine avec un enregistrement CNAME. En effet, l'enregistrement CNAME remplace l'enregistrement TXT et fait apparaître le domaine comme non validé.

        Si les méthodes de validation du domaine n'offrent pas l'option d'enregistrement CNAME, vous pouvez sélectionner Autre comme 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 Vous rencontrez des problèmes ?, cliquez sur Ajouter un enregistrement CNAME, puis suivez les instructions pour valider la propriété du domaine.

          Notez que vous devrez peut-être patienter une minute pour que l'enregistrement CNAME soit défini dans le service d'enregistrement de noms de domaine.

      2. Revenez au formulaire Ajouter un nom de domaine personnalisé dans la console GCP.
    gcloud
    1. Exécutez la commande gcloud domains suivante pour ouvrir la page du 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. Utilisez le Centre pour les webmasters afin de valider la propriété du domaine.

      Important : La validation de la propriété d'un domaine à l'aide d'un enregistrement CNAME est l'option recommandée pour App Engine. Si vous choisissez d'utiliser un enregistrement TXT, vous devez éviter de configurer les paramètres DNS du domaine avec un enregistrement CNAME. En effet, l'enregistrement CNAME remplace l'enregistrement TXT et fait apparaître le domaine comme non validé.

      Si les méthodes de validation du domaine n'offrent pas l'option d'enregistrement CNAME, vous pouvez sélectionner Autre comme 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 Vous rencontrez des problèmes ?, cliquez sur Ajouter un enregistrement CNAME, puis suivez les instructions pour valider la propriété du domaine.

        Notez que vous devrez peut-être patienter une minute pour que l'enregistrement CNAME soit défini dans le service d'enregistrement de noms de domaine.

      Exemple
      Pour ajouter l'enregistrement CNAME suivant à la configuration DNS du domaine :
      CNAME Label / Host: a1b2c3d4e5.example.com.
      CNAME Destination / Target: gv-abcdefghijk.dv.googlehosted.com
      Vous devez mapper les valeurs Label / Host et Destination / Target sur les champs correspondants de la configuration DNS du domaine. Par exemple, dans Google Domains, vous allez définir l'enregistrement 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 les instructions relatives au domaine, reportez-vous à la page d'assistance.

  2. Assurez-vous que votre domaine a été validé, sinon vous ne pourrez pas effectuer les étapes suivantes. Sachez 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
    API

    Pour répertorier de manière automatisée les domaines validés, reportez-vous à la méthode apps.authorizedDomains.list dans l'API Admin.

  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 du Centre pour les webmasters en procédant comme indiqué ci-dessous :

    1. Accédez à l'adresse suivante dans votre navigateur Web :

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

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

    3. Faites défiler l'écran vers le bas jusqu'à la liste des Propriétaires validés, cliquez sur 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. Après avoir validé la propriété de votre domaine, vous pouvez le mapper à votre application App Engine.

    Console

    Passez à l'étape suivante du formulaire Ajouter un nom de domaine personnalisé pour sélectionner le domaine que vous souhaitez mapper à votre application App Engine :

    1. Spécifiez le domaine et les sous-domaines que vous souhaitez mapper. Le domaine nu et le sous-domaine www sont déjà renseignés dans le formulaire.
      • Un domaine nu (example.com, par exemple) est mappé sur http://example.com.
      • Un sous-domaine (www, par exemple) 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 informations à la configuration DNS du domaine.

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

      Ajouter un domaine personnalisé
    gcloud

    Exécutez la commande gcloud app domain-mappings suivante pour mapper le domaine à votre application App Engine :

    gcloud app domain-mappings create DOMAIN
    • DOMAIN est le domaine que vous souhaitez mapper à votre application App Engine, tel que *.example.com.
    • Si une erreur est renvoyée, placez le domaine entre apostrophes 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 devez ajouter ces détails à la configuration DNS du domaine.
    API

    Pour mapper de manière automatisée le domaine à votre application App Engine, reportez-vous à la méthode app.domainMappings.create de l'API Admin.

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

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

    1. Connectez-vous au compte que vous avez créé auprès du service d'enregistrement de noms de domaine, puis ouvrez la page de configuration DNS.

    2. Recherchez la section des enregistrements d'hôtes sur la page de configuration de votre domaine, puis ajoutez chacun des enregistrements de ressources que vous avez reçus lorsque vous avez mappé votre domaine sur votre 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 à la configuration DNS correspond au nom d'hôte www et à l'adresse ghs.googlehosted.com. Pour spécifier un domaine nu, utilisez plutôt @ avec l'adresse ghs.googlehosted.com.

      En cas de migration depuis un autre fournisseur, assurez-vous que tous les enregistrements DNS pointent vers l'application App Engine.

      Pour en savoir plus sur le mappage du domaine, consultez les sections Utiliser des sous-domaines et Mappages génériques qui figurent ci-dessous.

    3. Enregistrez les modifications dans la page de configuration DNS du compte du domaine. Cela peut prendre un certain temps pour que ces changements prennent effet.

  6. Vérifiez si la procédure a été exécutée correctement en accédant à votre application via sa nouvelle URL de domaine (www.example.com, par exemple).

Utiliser des sous-domaines

Si vous configurez un mappage générique de sous-domaine pour votre domaine personnalisé, votre application répond aux demandes 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.
  • Il existe une limite de 20 certificats SSL gérés par semaine pour chaque domaine de base. Si vous atteignez la limite, App Engine continue de délivrer des certificats gérés jusqu'à ce que toutes les requêtes soient traitées.

Mappages génériques

Vous pouvez utiliser des caractères génériques pour mapper des sous-domaines à n'importe quel niveau, en commençant par les sous-domaines de troisième niveau. Par exemple, si votre domaine est example.com et si vous saisissez du texte dans le champ de l'adresse Web :

  • La saisie de *.example.com mappe tous les sous-domaines de example.com sur votre application.
  • Tous les sous-domaines de *.private.example.com sont mappés sur votre application si vous saisissez private.example.com.
  • Tous les sous-domaines de *.nichol.sharks.nhl.example.com sont mappés sur votre application si vous saisissez nichol.sharks.nhl.example.com.
  • Tous les sous-domaines de *.excogitate.system.example.com sont mappés sur votre application si vous saisissez excogitate.system.example.com.

Vous pouvez utiliser les mappages 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 du domaine, tels que sites et mail, ces mappages ont une priorité supérieure et sont mis en correspondance en premier, avant tout mappage générique. En outre, si d'autres applications App Engine sont mappées à d'autres sous-domaines, ces mappages ont également une priorité plus élevée que n'importe quel mappage générique.

Certains fournisseurs DNS peuvent ne pas accepter le mappage générique de sous-domaine. 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ériques s'appliquent aux URL contenant des composants pour les services, les versions et les instances, conformément aux règles de routage de services 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 flexible App Engine pour les documents Ruby