4.7. Configurer des domaines personnalisés pour les services Knative

Procédure

1. Créez un fichier YAML contenant le CR DomainMapping dans le même espace de noms que le CR cible que vous souhaitez mapper :

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
    name: <domain_name> 1
    namespace: <namespace> 2
   spec:
    ref:
      name: <target_name> 3
      kind: <target_type> 4
      apiVersion: serving.knative.dev/v1

   1

   Le nom de domaine personnalisé que vous souhaitez associer au CR cible.

   2

   L'espace de noms du CR DomainMapping et du CR cible.

   3

   Le nom du CR cible à mettre en correspondance avec le domaine personnalisé.

   4

   Le type de CR mappé au domaine personnalisé.

   Exemple de mappage de domaine de service

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
    name: example-domain
    namespace: default
   spec:
    ref:
      name: example-service
      kind: Service
      apiVersion: serving.knative.dev/v1

   Exemple de mappage de domaines de routes

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
    name: example-domain
    namespace: default
   spec:
    ref:
      name: example-route
      kind: Route
      apiVersion: serving.knative.dev/v1

2. Appliquer le CR DomainMapping sous la forme d'un fichier YAML :

   $ oc apply -f <filename>

Procédure

1. Naviguez jusqu'à la page Topology.
2. Cliquez avec le bouton droit de la souris sur le service que vous voulez mapper à un domaine, et sélectionnez l'option Edit qui contient le nom du service. Par exemple, si le service s'appelle example-service, sélectionnez l'option Edit example-service.

3. Dans la section Advanced options, cliquez sur Show advanced Routing options.

   1. Si le CR de mappage de domaine que vous souhaitez mapper au service existe déjà, vous pouvez le sélectionner dans la liste Domain mapping.
   2. Si vous voulez créer un nouveau CR de mappage de domaine, tapez le nom de domaine dans la case et sélectionnez l'option Create. Par exemple, si vous tapez example.com, l'option Create est Create "example.com".
4. Cliquez sur Save pour enregistrer les modifications apportées à votre service.

Vérification

1. Naviguez jusqu'à la page Topology.
2. Cliquez sur le service que vous avez créé.
3. Dans l'onglet Resources de la fenêtre d'information sur le service, vous pouvez voir le domaine que vous avez mappé au service listé sous Domain mappings.

Procédure

1. Naviguez jusqu'à CustomResourceDefinitions et utilisez la boîte de recherche pour trouver la définition de ressource personnalisée (CRD) DomainMapping.
2. Cliquez sur le CRD DomainMapping, puis naviguez jusqu'à l'onglet Instances.
3. Cliquez sur Create DomainMapping.

4. Modifiez le YAML pour le CR DomainMapping afin qu'il inclue les informations suivantes pour votre instance :

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
    name: <domain_name> 1
    namespace: <namespace> 2
   spec:
    ref:
      name: <target_name> 3
      kind: <target_type> 4
      apiVersion: serving.knative.dev/v1

   1

   Le nom de domaine personnalisé que vous souhaitez associer au CR cible.

   2

   L'espace de noms du CR DomainMapping et du CR cible.

   3

   Le nom du CR cible à mettre en correspondance avec le domaine personnalisé.

   4

   Le type de CR mappé au domaine personnalisé.

   Exemple de mappage d'un domaine vers un service Knative

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
    name: custom-ksvc-domain.example.com
    namespace: default
   spec:
    ref:
      name: example-service
      kind: Service
      apiVersion: serving.knative.dev/v1

Procédure

1. Créez un secret TLS Kubernetes :

   $ oc create secret tls <tls_secret_name> --cert=<path_to_certificate_file> --key=<path_to_key_file>

2. Ajoutez le label networking.internal.knative.dev/certificate-uid: <id>` au secret TLS de Kubernetes :

   $ oc label secret <tls_secret_name> networking.internal.knative.dev/certificate-uid="<id>"

   Si vous utilisez un fournisseur de secret tiers tel que cert-manager, vous pouvez configurer votre gestionnaire de secret pour étiqueter automatiquement le secret TLS de Kubernetes. Les utilisateurs de Cert-manager peuvent utiliser le modèle de secret proposé pour générer automatiquement des secrets avec l'étiquette correcte. Dans ce cas, le filtrage des secrets est effectué sur la base de la clé uniquement, mais cette valeur peut contenir des informations utiles telles que l'ID du certificat que le secret contient.

   Note

   L'opérateur cert-manager pour Red Hat OpenShift est une fonctionnalité de l'aperçu technologique. Pour plus d'informations, consultez la documentation Installing the cert-manager Operator for Red Hat OpenShift.

3. Mettez à jour le CR DomainMapping pour utiliser le secret TLS que vous avez créé :

   apiVersion: serving.knative.dev/v1alpha1
   kind: DomainMapping
   metadata:
     name: <domain_name>
     namespace: <namespace>
   spec:
     ref:
       name: <service_name>
       kind: Service
       apiVersion: serving.knative.dev/v1
   # TLS block specifies the secret to be used
     tls:
       secretName: <tls_secret_name>

Vérification

1. Vérifiez que l'état de la CR DomainMapping est True et que la colonne URL de la sortie indique le domaine mappé avec le schéma https:

   oc get domainmapping <domain_name>

   Exemple de sortie

   NAME                      URL                               READY   REASON
   example.com               https://example.com               True

2. Facultatif : si le service est exposé publiquement, vérifiez qu'il est disponible en exécutant la commande suivante :

   $ curl https://<domain_name>

   Si le certificat est auto-signé, passez la vérification en ajoutant le drapeau -k à la commande curl.