Einrichten von Dependabot zum Ausführen von auf gehosteten Aktionsrunnern mithilfe des privaten Azure-Netzwerks

Dieser Artikel enthält schrittweise Anleitungen zum Ausführen von Dependabot auf Runner, die auf gehostet werden und mit einem VNet konfiguriert sind. In diesem Artikel wird Folgendes erläutert:

• Erstellen von Runnergruppen für dein Unternehmen oder deine Organisation mit einer VNet-Konfiguration
• Erstellen von Runnern für Dependabot in der Runnergruppe, die auf gehostet werden
• Aktivieren von Dependabot für große Runner
• Konfigurieren von IP-Regeln für die VNet-Firewall in Azure

Um Runner mit einem Azure-VNet zu verwenden, die auf gehostet werden, musst du zunächst deine Azure-Ressourcen konfigurieren und anschließend in eine Konfiguration für ein privates Netzwerk erstellen.

Informationen zum Verwenden von Runnern mit einem privaten Azure-Netzwerk, die auf gehostet werden, findest du unter Konfigurieren deiner Azure-Ressourcen.

Nachdem du deine Azure-Ressourcen konfiguriert hast, kannst du ein virtuelles Azure-Netzwerk (VNET) für private Netzwerke verwenden. Erstelle hierzu eine Netzwerkkonfiguration auf Unternehmens- oder Organisationsebene. Anschließend kannst du diese Netzwerkkonfiguration Runnergruppen zuordnen.

1. Füge eine neue Netzwerkkonfiguration für dein Unternehmen hinzu. Weitere Informationen findest du unter Hinzufügen einer neuen Netzwerkkonfiguration für dein Unternehmen.
2. Erstelle eine Runnergruppe für das Unternehmen, und wähle die Organisationen aus, für die du Dependabot updates ausführen möchtest. Weitere Informationen findest du unter Erstellen einer Runnergruppe für dein Unternehmen.
3. Erstelle einen Runner, der auf gehostet wird, und füge ihn der Runnergruppe deines Unternehmens hinzu. Weitere Informationen findest du unter Hinzufügen eines größeren Runners zu einem Unternehmen. Wichtige Punkte:

   • Der Runnername muss dependabot lauten.

   • Wähle eine Linux-x64-Plattform aus.

   • Wähle die geeignete Ubuntu-Version aus.

   • Wähle die Runnergruppe aus, die du im vorherigen Schritt erstellt hast, wenn du deine Runner, die auf gehostet werden, einer Runnergruppe hinzufügst.

   Hinweis

   Durch die Benennung des Runners, der auf gehostet wird, in dependabot wird diesem die Bezeichnung dependabot zugewiesen, die es dem Runner ermöglicht, Aufträge abzurufen, die von Dependabot für Aktionen ausgelöst werden.

Du musst Dependabot jetzt für selbstgehostete Runnern für deine Organisation aktivieren, um Dependabot für große Runner zu aktivieren. Weitere Informationen findest du unter Aktivieren oder Deaktivieren von Dependabot für größere Runner.

1. Wähle in der rechten oberen Ecke auf dein Profilfoto aus, und klicke dann auf Your organizations.

2. Klicke unter deinem Organisationsnamen auf die Option Einstellungen. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Wähle im Abschnitt „Security“ der Randleiste das Dropdownmenü Advanced Security aus, und klicke auf Global settings.

4. Wähle unter Dependabot die Option Dependabot on self-hosted runners aus. Dieser Schritt ist erforderlich, damit zukünftige Dependabot-Aufträge auf dem größeren Runner mit dem Namen dependabot ausgeführt werden, der auf gehostet wird.

Nachdem du nun mit VNet ein privates Netzwerk eingerichtet hast, kannst du eine Dependabot-Ausführung starten.

1. Navigieren Sie auf zur Hauptseite des Repositorys.

2. Klicke unter dem Repositorynamen auf die Registerkarte Insights.

3. Klicke auf der linken Randleiste auf Abhängigkeitsdiagramm.

   

4. Klicke unter „Abhängigkeitsdiagramm“ auf Dependabot .

5. Klicke rechts neben dem Namen der relevanten Manifestdatei auf Recent update jobs.

6. Wenn keine kürzlichen Aktualisierungsaufträge für die Manifestdatei vorhanden sind, klicke auf Check for updates, um einen Dependabot-Versionsupdateauftrag erneut auszuführen und nach neuen Updates für Abhängigkeiten für dieses Ökosystem zu suchen.

• Auf der Registerkarte Actions deines Repositorys kannst du die Protokolle des Dependabot-Workflows anzeigen. Wähle auf der linken Randleiste der Seite „Actions“ den Dependabot-Auftrag aus.

  

• Auf der Seite mit den Informationen zum Runner kannst du die aktiven Aufträge anzeigen. Klicke auf die Registerkarte Policies für das Unternehmen, wähle auf der linken Randleiste die Option Actions aus, klicke auf die Registerkarte Runner group, und wähle deinen Runner aus, um auf diese Seite zuzugreifen.

  

Wenn deine VNet-Umgebung in Azure mit einer Firewall mit einer Liste zugelassener IP-Adressen konfiguriert ist, musst du deine Liste der zugelassenen IP-Adressen möglicherweise aktualisieren, damit die IP-Adressen der Runner vom Meta-API-Endpunkt verwendet werden, die auf gehostet werden.

• stellt den folgenden öffentlichen Endpunkt für IP-Bereiche bereit:

  GET https://api..com/meta

• Kopiere den folgenden cURL-Befehl, und füge diesen im Terminal oder in der Eingabeaufforderung ein. Ersetze anschließend den Platzhalterwert für das Bearertoken durch den tatsächlichen Wert.

  Bash

        curl -L \
        -H "Accept: application/vnd.+json" \
        -H "Authorization: Bearer YOUR-TOKEN" \
        -H "X--Api-Version: 2022-11-28" \
        https://api..com/meta
  

• Suche in der Antwort nach dem Actions-Schlüssel.

      "actions": [ ... ]
  

  Hierbei handelt es sich um die IP-Bereiche, die von Actions-Runnern verwendet werden, einschließlich Dependabot und gehosteten Läufern.

• Füge deiner Liste zugelassener IP-Adressen diese IPs hinzu.