Agent Skills › nixopus/nixopus › elixir-deploy

elixir-deploy

GitHub

提供 Elixir/Phoenix 应用的构建与部署指南，涵盖版本检测、依赖编译、Mix Release 生成及 Dockerfile 编写模式，用于自动化部署流程。

api/skills/elixir-deploy/SKILL.md nixopus/nixopus

Trigger Scenarios

需要构建或部署 Elixir 项目时检测到 mix.exs 文件时生成 Phoenix 应用 Dockerfile 时

Install

npx skills add nixopus/nixopus --skill elixir-deploy -g -y

More Options

Non-standard path

npx skills add https://github.com/nixopus/nixopus/tree/master/api/skills/elixir-deploy -g -y

Use without installing

npx skills use nixopus/nixopus@elixir-deploy

指定 Agent (Claude Code)

npx skills add nixopus/nixopus --skill elixir-deploy -a claude-code -g -y

安装 repo 全部 skill

npx skills add nixopus/nixopus --all -g -y

预览 repo 内 skill

npx skills add nixopus/nixopus --list

SKILL.md

Frontmatter

{
    "name": "elixir-deploy",
    "metadata": {
        "version": "1.0"
    },
    "description": "Build and deploy Elixir and Phoenix applications — version detection, mix releases, and Dockerfile patterns. Use when deploying an Elixir or Phoenix project, or when mix.exs is detected."
}

Elixir Deployment

Detection

Project is Elixir if mix.exs exists in the root.

Versions

Elixir

.elixir-version file
mix.exs → detected from project
mise.toml or .tool-versions
Defaults to 1.18

Erlang (OTP)

.erlang-version file
Resolved automatically from Elixir version
mise.toml or .tool-versions
Defaults to 27.3

Build

Build Process

Install Elixir and Erlang
Get and compile deps: mix deps.get --only prod and mix deps.compile
If defined: mix assets.setup
If defined: mix assets.deploy and mix ecto.deploy
Compile and release: mix compile and mix release

Start Command

/app/_build/prod/rel/<app_name>/bin/<app_name> start

Framework Detection

Signal	Framework
`mix.exs` + `phoenix` dep	Phoenix
`config/config.exs`	Standard Elixir app
`config/runtime.exs`	Runtime config (prod)

Phoenix-Specific

Asset pipeline: Node.js or esbuild; run mix assets.setup and mix assets.deploy
Ecto: mix ecto.setup (dev) / mix ecto.deploy (prod)
Release: mix release produces standalone tarball/binary

Install Stage Optimization

Copy in order:

mix.exs, mix.lock
config/ (full config directory)
lib/, test/, assets/ (Phoenix)

Base Images

Stage	Image
Build	`hexpm/elixir:1.18-erlang-27.3` or `elixir:1.18`
Runtime	`debian:bookworm-slim` + extracted release, or `elixir:1.18-slim`

Dockerfile Patterns

Phoenix Release

FROM hexpm/elixir:1.18-erlang-27.3 AS build
WORKDIR /app
RUN mix local.hex --force && mix local.rebar --force
COPY mix.exs mix.lock ./
RUN mix deps.get --only prod && mix deps.compile
COPY config config
COPY lib lib
COPY priv priv
COPY assets assets
RUN mix assets.deploy
RUN mix compile
RUN mix release

FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y libssl3 ca-certificates && rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY --from=build /app/_build/prod/rel/my_app ./
EXPOSE 4000
CMD ["./bin/my_app", "start"]

Plain Elixir (no Phoenix)

FROM hexpm/elixir:1.18-erlang-27.3 AS build
WORKDIR /app
COPY mix.exs mix.lock ./
RUN mix deps.get --only prod && mix deps.compile
COPY config config
COPY lib lib
RUN mix compile && mix release

FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y libssl3 ca-certificates && rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY --from=build /app/_build/prod/rel/my_app ./
CMD ["./bin/my_app", "start"]