3.5. Installation de Knative Eventing

Procédure

1. Dans la perspective Administrator de la console web OpenShift Container Platform, naviguez vers Operators Installed Operators.
2. Vérifiez que le menu déroulant Project en haut de la page est bien réglé sur Project: knative-eventing.
3. Cliquez sur Knative Eventing dans la liste de Provided APIs pour l'OpenShift Serverless Operator afin d'accéder à l'onglet Knative Eventing.
4. Cliquez sur Create Knative Eventing.

5. Dans la page Create Knative Eventing, vous pouvez choisir de configurer l'objet KnativeEventing en utilisant le formulaire par défaut fourni ou en modifiant le YAML.

   • L'utilisation du formulaire est recommandée pour les configurations plus simples qui ne nécessitent pas un contrôle total de la création des objets KnativeEventing.

     Facultatif. Si vous configurez l'objet KnativeEventing à l'aide du formulaire, apportez les modifications que vous souhaitez mettre en œuvre pour votre déploiement Knative Eventing.

6. Cliquez sur Create.

   • Il est recommandé d'éditer le YAML pour les configurations plus complexes qui nécessitent un contrôle total de la création des objets KnativeEventing. Vous pouvez accéder au YAML en cliquant sur le lien edit YAML en haut à droite de la page Create Knative Eventing.

     Facultatif. Si vous configurez l'objet KnativeEventing en modifiant le YAML, apportez toutes les modifications au YAML que vous souhaitez mettre en œuvre pour votre déploiement Knative Eventing.

7. Cliquez sur Create.
8. Après avoir installé Knative Eventing, l'objet KnativeEventing est créé et vous êtes automatiquement dirigé vers l'onglet Knative Eventing. Vous verrez la ressource personnalisée knative-eventing dans la liste des ressources.

Vérification

1. Cliquez sur la ressource personnalisée knative-eventing dans l'onglet Knative Eventing.

2. Vous êtes automatiquement dirigé vers la page Knative Eventing Overview.

   
3. Faites défiler la page vers le bas pour consulter la liste de Conditions.

4. La liste des conditions dont l'état est True s'affiche, comme le montre l'image d'exemple.

   
   Note

   La création des ressources Knative Eventing peut prendre quelques secondes. Vous pouvez vérifier leur statut dans l'onglet Resources.

5. Si les conditions ont un statut de Unknown ou False, attendez quelques instants et vérifiez à nouveau après avoir confirmé que les ressources ont été créées.

Procédure

1. Créez un fichier nommé eventing.yaml.

2. Copiez l'exemple suivant de YAML dans eventing.yaml:

   apiVersion: operator.knative.dev/v1beta1
   kind: KnativeEventing
   metadata:
       name: knative-eventing
       namespace: knative-eventing

3. Facultatif. Apportez toutes les modifications au YAML que vous souhaitez mettre en œuvre pour votre déploiement Knative Eventing.

4. Appliquez le fichier eventing.yaml en entrant :

   $ oc apply -f eventing.yaml

Vérification

1. Vérifiez que l'installation est terminée en entrant la commande suivante et en observant la sortie :

   $ oc get knativeeventing.operator.knative.dev/knative-eventing \
     -n knative-eventing \
     --template='{{range .status.conditions}}{{printf "%s=%s\n" .type .status}}{{end}}'

   Exemple de sortie

   InstallSucceeded=True
   Ready=True

   Note

   La création des ressources Knative Eventing peut prendre quelques secondes.

2. Si les conditions ont un statut de Unknown ou False, attendez quelques instants et vérifiez à nouveau après avoir confirmé que les ressources ont été créées.

3. Vérifier que les ressources Knative Eventing ont été créées en entrant :

   $ oc get pods -n knative-eventing

   Exemple de sortie

   NAME                                   READY   STATUS    RESTARTS   AGE
   broker-controller-58765d9d49-g9zp6     1/1     Running   0          7m21s
   eventing-controller-65fdd66b54-jw7bh   1/1     Running   0          7m31s
   eventing-webhook-57fd74b5bd-kvhlz      1/1     Running   0          7m31s
   imc-controller-5b75d458fc-ptvm2        1/1     Running   0          7m19s
   imc-dispatcher-64f6d5fccb-kkc4c        1/1     Running   0          7m18s

Procédure

1. Dans la perspective Administrator, naviguez vers Operators Installed Operators.
2. Vérifiez que le menu déroulant Project en haut de la page est bien réglé sur Project: knative-eventing.
3. Dans la liste de Provided APIs pour l'OpenShift Serverless Operator, trouvez la boîte Knative Kafka et cliquez sur Create Instance.

4. Configurez l'objet KnativeKafka dans la page Create Knative Kafka.

   Important

   Pour utiliser le canal, la source, le courtier ou le puits Kafka sur votre cluster, vous devez basculer le commutateur enabled pour les options que vous souhaitez utiliser sur true. Ces commutateurs sont réglés sur false par défaut. En outre, pour utiliser le canal, le courtier ou le puits Kafka, vous devez spécifier les serveurs d'amorçage.

   Exemple KnativeKafka ressource personnalisée

   apiVersion: operator.serverless.openshift.io/v1alpha1
   kind: KnativeKafka
   metadata:
       name: knative-kafka
       namespace: knative-eventing
   spec:
       channel:
           enabled: true 1
           bootstrapServers: <bootstrap_servers> 2
       source:
           enabled: true 3
       broker:
           enabled: true 4
           defaultConfig:
               bootstrapServers: <bootstrap_servers> 5
               numPartitions: <num_partitions> 6
               replicationFactor: <replication_factor> 7
       sink:
           enabled: true 8

   1

   Permet aux développeurs d'utiliser le type de canal KafkaChannel dans le cluster.

   2

   Une liste de serveurs d'amorçage de votre cluster AMQ Streams, séparés par des virgules.

   3

   Permet aux développeurs d'utiliser le type de source d'événement KafkaSource dans le cluster.

   4

   Permet aux développeurs d'utiliser l'implémentation du courtier Knative pour Apache Kafka dans le cluster.

   5

   Une liste de serveurs d'amorçage de votre cluster Red Hat AMQ Streams, séparée par des virgules.

   6

   Définit le nombre de partitions des sujets Kafka, soutenus par les objets Broker. La valeur par défaut est 10.

   7

   Définit le facteur de réplication des sujets Kafka, soutenu par les objets Broker. La valeur par défaut est 3.

   8

   Permet aux développeurs d'utiliser un puits Kafka dans le cluster.

   Note

   La valeur replicationFactor doit être inférieure ou égale au nombre de nœuds de votre cluster Red Hat AMQ Streams.

   1. L'utilisation du formulaire est recommandée pour les configurations plus simples qui ne nécessitent pas un contrôle total de la création des objets KnativeKafka.
   2. Il est recommandé d'éditer le YAML pour les configurations plus complexes qui nécessitent un contrôle total de la création des objets KnativeKafka. Vous pouvez accéder au YAML en cliquant sur le lien Edit YAML en haut à droite de la page Create Knative Kafka.
5. Cliquez sur Create après avoir effectué l'une des configurations optionnelles pour Kafka. Vous êtes automatiquement dirigé vers l'onglet Knative Kafka où se trouve knative-kafka dans la liste des ressources.

Vérification

1. Cliquez sur la ressource knative-kafka dans l'onglet Knative Kafka. Vous êtes automatiquement dirigé vers la page Knative Kafka Overview.

2. Consulter la liste de Conditions pour la ressource et confirmer qu'ils ont un statut de True.

   

   Si les conditions ont un statut de Unknown ou False, attendez quelques instants pour rafraîchir la page.

3. Vérifier que les ressources Knative broker for Apache Kafka ont été créées :

   $ oc get pods -n knative-eventing

   Exemple de sortie

   NAME                                        READY   STATUS    RESTARTS   AGE
   kafka-broker-dispatcher-7769fbbcbb-xgffn    2/2     Running   0          44s
   kafka-broker-receiver-5fb56f7656-fhq8d      2/2     Running   0          44s
   kafka-channel-dispatcher-84fd6cb7f9-k2tjv   2/2     Running   0          44s
   kafka-channel-receiver-9b7f795d5-c76xr      2/2     Running   0          44s
   kafka-controller-6f95659bf6-trd6r           2/2     Running   0          44s
   kafka-source-dispatcher-6bf98bdfff-8bcsn    2/2     Running   0          44s
   kafka-webhook-eventing-68dc95d54b-825xs     2/2     Running   0          44s