Puppet-Integrationshandbuch

Puppet bietet eine standardisierte Methode zum Bereitstellen und Betreiben von Software, unabhängig davon, wo sie ausgeführt wird. Mit dem Puppet-Ansatz definieren Sie mithilfe einer gemeinsamen, leicht verständlichen Sprache, wie Ihre Apps und Infrastruktur aussehen sollen. Von dort aus können Sie die gewünschten Änderungen in Ihrem Rechenzentrum freigeben, testen und durchsetzen. Und bei jedem Schritt haben Sie die Transparenz und Berichte, die Sie benötigen, um Entscheidungen zu treffen und die Einhaltung von Vorschriften nachzuweisen.

In PagerDuty

1. Gehen Sie zum Aufbau und wählen Sie Dienstleistungen .

2. Auf der Seite „Dienste“:

   • Wenn Sie einen neuen Dienst für Ihre Integration erstellen, klicken Sie auf Neuen Dienst hinzufügen .

   • Wenn Sie Ihre Integration zu einem vorhandenen Dienst hinzufügen, klicken Sie auf den Namen des Dienstes, zu dem Sie die Integration hinzufügen möchten. Klicken Sie dann auf Integrationen und klicken Sie auf die Neue Integration Taste.

     

     

3. Wählen Sie Ihre App aus dem Integrationstyp und geben Sie eine Integrationsname .

   Wenn Sie einen neuen Dienst für Ihre Integration erstellen, geben Sie in den Allgemeinen Einstellungen einen Name für Ihren neuen Dienst. Geben Sie dann in den Vorfalleinstellungen die Eskalationsrichtlinie , Dringlichkeit der Benachrichtigung , Und Vorfallverhalten für Ihren neuen Service.

4. Drücke den Service hinzufügen oder Integration hinzufügen Schaltfläche, um Ihre neue Integration zu speichern. Sie werden auf die Integrationsseite für Ihren Dienst weitergeleitet.

   

5. Kopiere das Integrationsschlüssel für Ihre neue Integration.

   

In Ihrem Puppet Master Node

1. Installiere das pdsupport-pagerduty Modul:

    /opt/puppetlabs/bin/puppet-Modul installieren pdsupport-pagerduty 

2. Installieren Sie die erforderlichen Ruby-Abhängigkeiten:

    /opt/puppetlabs/server/bin/puppetserver gem install puppet 

    /opt/puppetlabs/server/bin/puppetserver gem install json 

    /opt/puppetlabs/server/bin/puppetserver gem install redphone 

3. Manuelle Installation der pagerduty.rb Skript:

   Hinweis: Dieser Schritt ist aufgrund eines Problems in Puppet erforderlich. Details zu diesem Problem sind dokumentiert Hier .

    cp /etc/puppetlabs/code/environments/production/modules/pagerduty/lib/puppet/reports/pagerduty.rb /opt/puppetlabs/puppet/lib/ruby/vendor_ruby/puppet/reports/ 

4. Füge hinzu ein pagerdienst Klasse zum Hauptmanifest Ihres Masterknotens:

    Klasse { 'Pagerduty': } 

5. Aufführen pagerdienst als Report-Handler auf Ihrem Master-Knoten puppet.conf Datei:

    [Master] Berichte = Pagerdienst 

6. Aktivieren Sie Pluginsync und Berichte auf Ihren Master- und Client-Knoten, falls dies noch nicht geschehen ist:

   Hinweis: Ab Puppet 3.0.0 sind diese Einstellungen standardmäßig auf „true“ eingestellt. Dieser Schritt ist nur erforderlich, wenn eine dieser Einstellungen auf „false“ gesetzt wurde.

   Sie können die Einstellungen manuell aktivieren in puppet.conf :

    [Master] Bericht = true Pluginsync = true [Agent] Bericht = true Pluginsync = true 

   Oder aktivieren Sie innerhalb der pagerdienst Klasse im Manifest Ihres Masterknotens:

    Klasse { 'pagerduty': pagerduty_puppet_reports => 'store,http,pagerduty', pagerduty_puppet_pluginsync => 'true', } 

7. Starten Sie den Puppenserver Service:

    sudo service puppetserver neu starten 

8. Beweg das pagerduty.yaml.erb Vorlage in Ihren Master Confdir - Übersetzung und benennen Sie die Datei pagerduty.yaml :

    mv /etc/puppetlabs/code/environments/production/modules/pagerduty/templates/pagerduty.yaml.erb /etc/puppetlabs/puppet/pagerduty.yaml 

9. Bearbeiten Sie Ihre pagerduty.yaml Datei und fügen Sie die Integrationsschlüssel Sie haben in Schritt 5 oben kopiert:

    sudo vi /etc/puppetlabs/puppet/pagerduty.yaml 

    --- :pagerduty_api: 'INTEGRATIONSSCHLÜSSEL_HIER_EINFÜGEN' 

10. Um zu testen, ob ein fehlgeschlagener Lauf einen PagerDuty Vorfall auslöst, bearbeiten Sie die pagerdienst Modul init.pp Manifestieren und Kommentieren der Zeilen 9-13:

     sudo vi /etc/puppetlabs/code/environments/produktion/modules/pagerduty/manifests/init.pp 

     wenn ! definiert(Dienst[$pagerduty_puppet_service]) { Dienst { $pagerduty_puppet_service : sicherstellen => ausgeführt, } } 

11. Führen Sie dann den Puppet-Agenten auf einem Ihrer Clientknoten aus:

     /opt/puppetlabs/bin/puppet agent --test 

FAQ

Mit welchen Puppet-Versionen ist diese Integration kompatibel?

Diese Integration wurde mit Puppet 3.x und 4.x getestet. Ältere Versionen von Puppet finden Sie unter dieses Modul , das für Puppet 2.x erstellt wurde.

Können Sie Puppet in mehrere PagerDuty -Dienste integrieren?

Jeder Puppet-Masterknoten kann nur mit einem PagerDuty Dienst integriert werden. Wenn Sie jedoch mehrere Puppet-Masterknoten in Ihrer Umgebung haben, können Sie jeden Knoten mit einem separaten Dienst in PagerDuty integrieren. Aktualisieren Sie einfach die Integrationsschlüssel in deinem pagerduty.yaml Datei, um auf den Dienst zu verweisen, den Sie in diesen bestimmten Knoten integrieren möchten.

Werden Vorfälle in PagerDuty automatisch gelöst, wenn der Lauf in Puppet erfolgreich ist?

Ja, der Vorfall in PagerDuty wird behoben, sobald der Lauf erfolgreich ist.

Wie werden fehlgeschlagene Puppet-Läufe bei PagerDuty Vorfällen dedupliziert?

Die Puppet-Läufe werden dedupliziert, basierend auf der Gastgeber das den Bericht generiert hat.

Wo finde ich Protokolle zur Fehlerbehebung bei dieser Integration?

Puppet-Logs befinden sich auf Ihrem Master-Knoten im logdir , die konfiguriert werden kann in puppet.conf Das Standardverzeichnis in Puppet 4.x ist:

 /var/log/puppetlabs/puppetserver