Notification d’évènement¶

Implémentations¶

Un bus d’évènement est introduit dans le Serveur de Gestion ce qui autorise les composants CloudStack et ses plug-ins d’extension à souscrire aux évènements en utilisant le client Advanced Message Queuing Protocol (AMQP). Dans CloudStack, une implémentation par défaut du bus d’évènement est fourni comme un plug-in qui utilise le client AMQP RabbitMQ. Le client AMQP pousse les évènements publiés à un serveur AMQP compatible. Par conséquent, tous les évènements CloudStack sont publiés sur un échange du serveur AMQP.

En complément, une implémentation en mémoire et une implémentation Apache Kafka sont toutes deux disponibles.

Cas d’usages¶

Les exemples suivants sont des cas d’usages :

• Moteurs de facturation ou d’utilisation. Une solution tiers d’utilisation du cloud peut implémenter un plugin qui peut se connecter à CloudStack pour s’abonner aux évènements CloudStack et généré des données d’utilisation. La donnée d’utilisation est utilisée par leur logiciel d’utilisation.

• Le plugin AMQP place tous les évènements dans une file de messages, un courtier de messages AMQP peut ensuite fournir une notification basée sur les sujets aux abonnés.

• Publier et souscrire au service de notifications peut être implémenté comme un service enfichable dans CloudStack qui peut fournir un ensemble riche d’API pour la notification d’évènements, comme une souscription ou une notification par sujets.

Configuration AMQP¶

En tant qu’administrateur CloudStack, effectuer la configuration suivante une fois pour activer le framework de notification d’évènement. En fonctionnement, aucun changement ne peut contrôler le comportement.

1. Créer le dossier /etc/cloudstack/management/META-INF/cloudstack/core

2. Dans ce dossier, ouvrir spring-event-bus-context.xml.

3. Définir un bean appelé eventNotificationBus comme ceci :

   • name : Spécifier un nom pour le bean.

   • server : Le nom ou l’adresse IP du serveur RabbitMQ AMQP.

   • port : Le port sur lequel le serveur RabbitMQ fonctionne.

   • username : Le nom d’utilisateur associé avec le compte pour accéder au serveur RabbitMQ.

   • password : Le mot de passe associé avec le nom d’utilisateur du compte pour accéder au serveur RabbitMQ.

   • exchange : Le nom d’échange sur le serveur RabbitMQ où les évènements sont publiés.

     Un exemple de bean est donné ci-dessous :

     <beans xmlns="http://www.springframework.org/schema/beans"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xmlns:context="http://www.springframework.org/schema/context"
     xmlns:aop="http://www.springframework.org/schema/aop"
     xsi:schemaLocation="http://www.springframework.org/schema/beans
     http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
     http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd
     http://www.springframework.org/schema/context
     http://www.springframework.org/schema/context/spring-context-3.0.xsd">
        <bean id="eventNotificationBus" class="org.apache.cloudstack.mom.rabbitmq.RabbitMQEventBus">
           <property name="name" value="eventNotificationBus"/>
           <property name="server" value="127.0.0.1"/>
           <property name="port" value="5672"/>
           <property name="username" value="guest"/>
           <property name="password" value="guest"/>
           <property name="exchange" value="cloudstack-events"/>
        </bean>
     </beans>
     

     Le bean eventNotificationBus bean représente la classe org.apache.cloudstack.mom.rabbitmq.RabbitMQEventBus.

     Si vous voulez utiliser une valeur chiffré pour le nom d’utilisateur et le mot de passe, vous devez inclure un bean pour fournir ceux-ci comme variable depuis un fichier d’identification.

     Un exemple est donné ci-dessous

     <beans xmlns="http://www.springframework.org/schema/beans"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xmlns:context="http://www.springframework.org/schema/context"
            xmlns:aop="http://www.springframework.org/schema/aop"
            xsi:schemaLocation="http://www.springframework.org/schema/beans
             http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
             http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd
             http://www.springframework.org/schema/context
             http://www.springframework.org/schema/context/spring-context-3.0.xsd"
     >
     
        <bean id="eventNotificationBus" class="org.apache.cloudstack.mom.rabbitmq.RabbitMQEventBus">
           <property name="name" value="eventNotificationBus"/>
           <property name="server" value="127.0.0.1"/>
           <property name="port" value="5672"/>
           <property name="username" value="${username}"/>
           <property name="password" value="${password}"/>
           <property name="exchange" value="cloudstack-events"/>
        </bean>
     
        <bean id="environmentVariablesConfiguration" class="org.jasypt.encryption.pbe.config.EnvironmentStringPBEConfig">
           <property name="algorithm" value="PBEWithMD5AndDES" />
           <property name="passwordEnvName" value="APP_ENCRYPTION_PASSWORD" />
        </bean>
     
        <bean id="configurationEncryptor" class="org.jasypt.encryption.pbe.StandardPBEStringEncryptor">
           <property name="config" ref="environmentVariablesConfiguration" />
        </bean>
     
        <bean id="propertyConfigurer" class="org.jasypt.spring3.properties.EncryptablePropertyPlaceholderConfigurer">
           <constructor-arg ref="configurationEncryptor" />
           <property name="location" value="classpath:/cred.properties" />
        </bean>
     </beans>
     

     Créer un nouveau fichier dans le même dossier appelé cred.properties et spécifier les valeurs pour le nom d’utilisateur et le mot de passe avec des chaînes de caractères javascripts cryptées.

     Par exemple, avec guest comme valeurs pour les deux champs :

     username=nh2XrM7jWHMG4VQK18iiBQ==
     password=nh2XrM7jWHMG4VQK18iiBQ==
     

4. Redémarrez votre serveur de gestion.

Configuration Kafka¶

En tant qu’administrateur CloudStack, effectuer la configuration suivante une fois pour activer le framework de notification d’évènement. En fonctionnement, aucun changement ne peut contrôler le comportement.

1. Créer un fichier de configuration approprié dans /etc/cloudstack/management/kafka.producer.properties qui contient les propriétés de configuration valides comme documenté dans http://kafka.apache.org/documentation.html#newproducerconfigs. Les propriétés peuvent contenir une propriété additionnelle topic qui, si elle n’est pas fournie, sera par défaut cloudstack. Comme key.serializer et value.serializer sont en général requis pour un producteur pour démarrer correctement, ils peuvent être omis et prendront par défaut la valeur org.apache.kafka.common.serialization.StringSerializer.

2. Créer le dossier /etc/cloudstack/management/META-INF/cloudstack/core

3. Dans ce dossier, ouvrir spring-event-bus-context.xml.

4. Définir un bean appelé eventNotificationBus``avec un seul attribut ``name. Un exemple de bean est donné ci-dessous :

   <beans xmlns="http://www.springframework.org/schema/beans"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xmlns:context="http://www.springframework.org/schema/context"
          xmlns:aop="http://www.springframework.org/schema/aop"
          xsi:schemaLocation="http://www.springframework.org/schema/beans
                              http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
                              http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd
                              http://www.springframework.org/schema/context
                              http://www.springframework.org/schema/context/spring-context-3.0.xsd">
      <bean id="eventNotificationBus" class="org.apache.cloudstack.mom.kafka.KafkaEventBus">
        <property name="name" value="eventNotificationBus"/>
      </bean>
    </beans>
   

5. Redémarrez votre serveur de gestion.

Permissions¶

Considérer ce qui suit :

• L’administrateur racine peut supprimer ou archiver une ou plusieurs alertes et évènements.

• L’administrateur de domaine ou l’utilisateur peuvent supprimer ou archiver un ou plusieurs évènements.

Procédure¶

1. Se connecter en tant qu’administrateur dans l’interface de CloudStack.

2. Dans le menu de navigation de gauche, cliquer sur Evènements.

3. Effectuer au choix :

   • Pour archiver les évènements, cliquer sur Archiver les évènements et spécifier le type d’évènement et la date.

   • Pour archiver les évènements, cliquer sur Détruire les évènements et spécifier le type d’évènement et la date.

4. Cliquer sur OK.