Einrichten des Toolcaches auf selbstgehosteten Runnern ohne Internetzugriff

Informationen zu den enthaltenen Setup-Aktionen und dem Runner-Tool-Cache

GitHub Actions auf GitHub Enterprise Server sind für die Arbeit in Umgebungen ohne vollständigen Internetzugriff konzipiert. Standardmäßig können Workflows keine Aktionen aus GitHub.com und GitHub Marketplace verwenden.

Die meisten offiziell GitHubverfassten Aktionen werden automatisch gebündelt mit GitHub Enterprise Server. Selbstgehostete Runner ohne Internetzugang müssen jedoch erst konfiguriert werden, bevor sie die enthaltenen actions/setup-LANGUAGE-Aktionen wie z. B. setup-node nutzen können.

Die actions/setup-LANGUAGE-Aktionen benötigen normalerweise Internetzugriff, um die erforderlichen Umgebungsbinärdateien in den Toolcache des Runners herunterzuladen. Selbstgehostete Runner ohne Internetzugriff können die Binärdateien nicht herunterladen, sodass du den Toolcache auf dem Runner manuell auffüllen musst.

Sie können den Läufertoolcache auffüllen, indem Sie einen GitHub Actions Workflow GitHub.com ausführen, der den Toolcache eines GitHubgehosteten Läufers als Artefakt hochlädt, den Sie dann in Ihrem selbst gehosteten selbst gehosteten Läufer übertragen und extrahieren können.

Voraussetzungen

• Du musst wissen, welche Entwicklungsumgebungen deine selbstgehosteten Runner benötigen. Im folgenden Beispiel wird veranschaulicht, wie ein Toolcache für die setup-node-Aktion mit den Node.js-Versionen 14 und 16 aufgefüllt wird.
• Zugriff auf ein Repository, auf GitHub.com dem Sie einen Workflow ausführen können.
• Greife auf das Dateisystem deines selbstgehosteten Runners zu, um den Ordner des Toolcaches aufzufüllen.

Auffüllen des Toolcaches für einen selbstgehosteten Runner

1. Navigieren Sie auf GitHub.com, zu einem Repository, mit dem Sie einen GitHub Actions Workflow ausführen können.

2. Erstellen Sie eine neue Workflowdatei im Ordner des .github/workflows Repositorys, die ein Artefakt hochlädt, das den Toolcache des GitHubgehosteten Läufers enthält.

   Das folgende Beispiel zeigt einen Workflow, der den Toolcache für eine Ubuntu 22.04-Umgebung hochlädt, wobei die Aktion setup-node mit den Node.js-Versionen 14 und 16 verwendet wird.

   name: Upload Node.js 14 and 16 tool cache
   on: push
   jobs:
     upload_tool_cache:
       runs-on: ubuntu-22.04
       steps:
         - name: Clear any existing tool cache
           run: |
             mv "${{ runner.tool_cache }}" "${{ runner.tool_cache }}.old"
             mkdir -p "${{ runner.tool_cache }}"
         - name: Setup Node 14
           uses: actions/setup-node@v4
           with:
             node-version: 14.x
         - name: Setup Node 16
           uses: actions/setup-node@v4
           with:
             node-version: 16.x
         - name: Archive tool cache
           run: |
             cd "${{ runner.tool_cache }}"
             tar -czf tool_cache.tar.gz *
         - name: Upload tool cache artifact
           uses: actions/upload-artifact@v3
           with:
             path: ${{runner.tool_cache}}/tool_cache.tar.gz
   

3. Lade das Tool-Cache-Artefakt aus der Workflow-Ausführung herunter. Weitere Informationen zum Herunterladen von Artefakten findest du unter Herunterladen von Workflowartefakten.

4. Übertrage das Toolcacheartefakt in deinen selbstgehosteten Runner, und extrahiere es in das lokale Toolcacheverzeichnis. Das Standardverzeichnis für den Toolcache ist RUNNER_DIR/_work/_tool. Wenn der Runner noch keine Aufträge verarbeitet hat, musst du möglicherweise die _work/_tool-Verzeichnisse erstellen.

   Nach dem Extrahieren des Toolcacheartefaktes, das im obigen Beispiel hochgeladen wurde, sollte eine Verzeichnisstruktur auf deinem selbstgehosteten Runner vorhanden sein, die dem folgenden Beispiel ähnelt:

   RUNNER_DIR
   ├── ...
   └── _work
       ├── ...
       └── _tool
           └── node
               ├── 14.21.3
               │   └── ...
               └── 16.16.0
                   └── ...
   

Dein selbstgehosteter Runner ohne Internetzugriff sollte jetzt in der Lage sein, die setup-node-Aktion zu verwenden. Wenn Probleme auftreten, stelle sicher, dass du den richtigen Toolcache für deine Workflows aufgefüllt hast. Wenn Sie beispielsweise die Aktion setup-python verwenden müssen, müssen Sie den Toolcache mit der Python Umgebung auffüllen, die Sie verwenden möchten.