Elixir in GitHub Actions beschleunigen
Zuletzt aktualisiert am
Um Elixir in GitHub Actions zu beschleunigen, installieren Sie Erlang und Elixir mit erlef/setup-beam, cachen deps und _build mit einem Schlüssel aus mix.lock sowie den OTP- und Elixir-Versionen und verteilen die Tests mit mix test --partitions. Elixir kompiliert schnell, aber ein Build ohne Cache kompiliert jede Abhängigkeit neu, einschließlich C-basierter wie bcrypt_elixir, und genau dort geht die meiste Zeit verloren.
Dieser Leitfaden zeigt einen vollständigen Phoenix-Workflow. Den allgemeinen Ansatz erklärt wie Sie GitHub Actions beschleunigen.
Erlang und Elixir installieren
erlef/setup-beam ist die in der Community übliche Action. Laut README setzen Sie otp-version und elixir-version als Zeichenketten oder verwenden version-file, um eine Datei .tool-versions zu lesen (Dateien mit der Endung .toml werden als mise-Konfiguration geparst). Bei einer Versionsdatei muss laut README version-type auf strict stehen. Kombinieren Sie keine Versionsdatei mit den YAML-Eingaben, sonst bricht die Action mit einem Fehler ab. Die README empfiehlt das bewegliche Tag v1, oder ein exaktes Tag wie v1.8.0, wenn Sie die Version festlegen möchten.
- uses: actions/checkout@v7
- uses: erlef/setup-beam@v1
id: beam
with:
otp-version: "27"
elixir-version: "1.18"
Die README führt otp-version und elixir-version als Ausgaben auf, die die exakt installierten Versionen enthalten. Verwenden Sie diese im Cache-Schlüssel.
deps und _build cachen
Die README enthält kein Rezept für das Caching, daher bauen Sie es selbst. Zwei Ordner sind wichtig: deps (geladene Abhängigkeiten) und _build (kompilierte Ausgabe). Der Schlüssel muss sich ändern, wenn sich die Lock-Datei oder eine der beiden Laufzeitversionen ändert, da _build nicht zwischen OTP-Versionen portabel ist.
- uses: actions/cache@v6
with:
path: |
deps
_build
key: mix-${{ runner.os }}-${{ steps.beam.outputs.otp-version }}-${{ steps.beam.outputs.elixir-version }}-${{ hashFiles('**/mix.lock') }}
restore-keys: |
mix-${{ runner.os }}-${{ steps.beam.outputs.otp-version }}-${{ steps.beam.outputs.elixir-version }}-
- run: mix deps.get
- run: mix compile --warnings-as-errors
Der Fallback über restore-keys bedeutet, dass eine geänderte mix.lock mit dem vorherigen _build startet, und Mix nur die geänderten Abhängigkeiten neu kompiliert. Das Ausführen von mix deps.get nach der Wiederherstellung des Caches ist sicher und schnell, da nur fehlende Pakete geladen werden. Achten Sie auf eine konsistente MIX_ENV: _build/test und _build/dev sind getrennte Ordner, und die CI sollte nur test kompilieren.
env:
MIX_ENV: test
Cache-Einträge sind unveränderlich und haben Größen- und Zeitlimits; siehe GitHub Actions Cache-Limits. Wächst _build mit der Zeit stark an, nehmen Sie ein Versionspräfix (mix-v2-) in den Schlüssel auf, damit Sie ihn zurücksetzen können.
Einen Postgres-Service verwenden
Phoenix-Apps mit Ecto benötigen eine Datenbank. Fügen Sie einen Service mit Health-Check hinzu:
services:
postgres:
image: postgres:17
env:
POSTGRES_PASSWORD: postgres
ports: ["5432:5432"]
options: >-
--health-cmd "pg_isready -U postgres"
--health-interval 5s --health-timeout 5s --health-retries 10
Setzen Sie config/test.exs auf localhost und lesen Sie den Host aus einer Umgebungsvariablen, damit es lokal und in der CI funktioniert. Der SQL-Sandbox von Ecto erlaubt parallele Tests, jeweils in einer eigenen Transaktion. Verwenden Sie daher use MyApp.DataCase, async: true, wo Tests keinen gemeinsamen globalen Zustand teilen.
Tests verteilen: Nebenläufigkeit, dann Partitionen
Elixir bietet zwei Ebenen der Testparallelität.
Innerhalb einer Maschine: ExUnit führt Testmodule mit async: true nebenläufig aus. Das Standardlimit max_cases beträgt das Doppelte der Scheduler-Anzahl, mehr Kerne bedeuten also mehr gleichzeitige Tests. Wandeln Sie so viele Module wie möglich in async: true um. Tests, die das Dateisystem, benannte Prozesse, globale Konfiguration oder Application.put_env berühren, sollten synchron bleiben.
Über mehrere Maschinen: mix test --partitions N teilt die Testdateien auf N Partitionen auf und führt eine davon aus, ausgewählt über die Umgebungsvariable MIX_TEST_PARTITION. Verwenden Sie eine Matrix:
strategy:
fail-fast: false
matrix:
partition: [1, 2, 3, 4]
steps:
# ...checkout, setup-beam, cache, deps...
- run: mix test --partitions 4
env:
MIX_TEST_PARTITION: ${{ matrix.partition }}
Bei Partitionen empfehlen die Ecto-Dokumente, die Partitionsnummer in den Datenbanknamen aufzunehmen, damit die Datenbank jedes Jobs getrennt ist: Verwenden Sie in config/test.exs database: "myapp_test#{System.get_env("MIX_TEST_PARTITION")}". Das ist nötig, wenn Partitionen denselben Datenbankserver teilen, etwa wenn Sie mehrere Partitionen auf derselben Maschine ausführen. Bei getrennten Jobs mit eigenen Service-Containern schadet es nicht, ist aber nicht zwingend erforderlich. Siehe Test-Sharding in GitHub Actions und den Shard-Rechner für Tests.
Linting, Formatierung und Dialyzer in eigenen Jobs
mix format --check-formattedbenötigt keine Kompilierung; führen Sie es zuerst aus, es schlägt schnell fehl.mix credo --strictist schnell.- Dialyzer (über Dialyxir) ist langsam, weil es eine PLT (Persistent Lookup Table) der Erlang- und Elixir-Module aufbaut. Cachen Sie den PLT-Ordner, zum Beispiel
priv/plts, mit einem Schlüssel aus OTP-Version, Elixir-Version undmix.lock. Eine warme PLT macht aus einem zehnminütigen Lauf einen kurzen. Führen Sie Dialyzer in einem eigenen Job aus, damit er die Tests nie blockiert.
Releases und Docker
Wenn Sie ein Release-Image bauen, kompilieren Sie die Abhängigkeiten in einer früheren Docker-Ebene als den App-Code und nutzen den BuildKit-Cache. Siehe Caching von Docker-Ebenen in der CI.
Was mehr CPU-Kerne bringen
Die BEAM nutzt für nebenläufige Tests jeden Kern, und mix compile kompiliert Dateien parallel. Unsere Benchmarks umfassen Phoenix LiveView + Postgres: 2m07s auf einem GitHub-gehosteten Runner und 1m03s auf compiler.dev (2.0x), ein vollständiger CI-Lauf mit 10 Test-Shards und einer echten Datenbank, gemessen am 8. Oktober 2026. Async-lastige Test-Suites profitieren am stärksten, da max_cases mit der Maschine skaliert.
Um es mit Ihrem Projekt zu testen, ändern Sie eine Zeile auf runs-on: [self-hosted, Linux, compiler-ci]. Siehe Preise und Vergleich. Verwandt: das Elixir-Template und GitHub Actions Caching.
FAQ
Was sollte der Elixir-Cache-Schlüssel enthalten?
Das Runner-Betriebssystem, die OTP-Version, die Elixir-Version und einen Hash von mix.lock. _build ist nicht sicher zwischen OTP-Versionen wiederverwendbar.
Funktioniert mix test --partitions mit Ecto?
Ja. Verwenden Sie die Variable MIX_TEST_PARTITION, um den Datenbanknamen pro Partition eindeutig zu machen, wenn Partitionen einen Datenbankserver teilen.
Sollte ich _build oder nur deps cachen?
Beides. Nur deps zu cachen spart Downloads, aber das Cachen von _build spart die Kompilierzeit, die meist größer ist.
Wie beschleunige ich Dialyzer in der CI?
Cachen Sie das PLT-Verzeichnis mit einem Schlüssel aus OTP-Version, Elixir-Version und mix.lock und führen Sie es als eigenen Job aus.
Verwandt
- TypeScript-Monorepo in GitHub Actions beschleunigenTypprüfung und Linting in TypeScript-Monorepos auf GitHub Actions beschleunigen: inkrementelles tsc, Projektreferenzen, Lint-Caches und parallele Jobs.
- Playwright im Monorepo mit GitHub Actions beschleunigenPlaywright-E2E-Tests in einem Node-Monorepo auf GitHub Actions beschleunigen: App einmal bauen, E2E überspringen, wenn sich die Web-App nicht ändert.
- CI-Geschwindigkeits-Badge in Ihre README einfügenZeigen Sie die Geschwindigkeit Ihrer CI mit einem README-Badge: die mediane Laufzeit Ihrer Repository-Workflows auf GitHub Actions, automatisch aktualisiert.
- .NET in GitHub Actions beschleunigen.NET-Builds in GitHub Actions beschleunigen: NuGet-Caching mit setup-dotnet, --no-restore, --no-build, paralleles dotnet test und SQL-Server-Services.