Hi,

I recently started a new Phoenix 1.7 and am struggling with generating deployment release using mix release over a mac using docker for deploying on Ubuntu 22.04 server.

I have a project running Phoenix 1.6 and use distillery for generating deployment release. It survived phoenix and esbuild upgrades and has been working fine for about 4 years

I am using same versions of erlang and elixir as in the old project since I ran into other issues like segmentation fault using newer versions of erlang/elixir combination. Hence, moved to stable versions that I know work fine for now till I am able to get the setup working and then will try to bump up the versions.

I copied most of the working code to current implementation. Finally got pretty much everything working after overcoming multiple challenges. The bit I am struggling with now is that the digetsted assests are not replaced in urls (app.js, app.css) in production.

My setup:

Docker images:

Dockerfile.1ubuntu

ARG UBUNTU_VERSION=noble-20240429

FROM --platform=linux/amd64 ubuntu:${UBUNTU_VERSION}

# Install necessary packages and clean up
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates \
    curl \
    netbase \
    wget \
    gnupg \
    dirmngr \
    git \
    openssh-client \
    subversion \
    procps \
    autoconf \
    automake \
    bzip2 \
    dpkg-dev \
    file \
    g++ \
    gcc \
    imagemagick \
    libbz2-dev \
    libc6-dev \
    libcurl4-openssl-dev \
    libdb-dev \
    libevent-dev \
    libffi-dev \
    libgdbm-dev \
    libgeoip-dev \
    libglib2.0-dev \
    libjpeg-dev \
    libkrb5-dev \
    liblzma-dev \
    libmagickcore-dev \
    libmagickwand-dev \
    libncurses5-dev \
    libncursesw5-dev \
    libpng-dev \
    libpq-dev \
    libreadline-dev \
    libsqlite3-dev \
    libssl-dev \
    libtool \
    libwebp-dev \
    libxml2-dev \
    libxslt-dev \
    libyaml-dev \
    make \
    patch \
    unzip \
    xz-utils \
    zlib1g-dev \
    gcc \
    g++ \
    make \
    libodbc2 \
    libsctp1 \
    libwxgtk3.0 \
    unixodbc-dev \
    libsctp-dev \
    xsltproc \
    fop \
    libxml2-utils \
    libwxgtk3.2-dev \
&& rm -rf /var/lib/apt/lists/*

Dockerfile.2erlang

FROM --platform=linux/amd64 my_app_ubuntu

ENV ELIXIR_VERSION="v1.14.5"
ENV OTP_VERSION="24.3.4.17"

# Install Erlang
RUN set -xe \
  && OTP_DOWNLOAD_URL="https://github.com/erlang/otp/archive/OTP-${OTP_VERSION}.tar.gz" \
  && curl -fSL -o otp-src.tar.gz "$OTP_DOWNLOAD_URL"

RUN set -xe \
  && export ERL_TOP="/usr/src/otp_src_${OTP_VERSION%%@*}" \
  && mkdir -vp $ERL_TOP \
  && tar -xzf otp-src.tar.gz -C $ERL_TOP --strip-components=1 \
  && rm otp-src.tar.gz \
  && ( cd $ERL_TOP \
    && ./otp_build autoconf \
    && gnuArch="$(dpkg-architecture --query DEB_BUILD_GNU_TYPE)" \
    && ./configure --host="$gnuArch" --target="$gnuArch" --disable-jit \
    && make -j$(nproc) \
    && make install ) \
  && find /usr/local -name examples | xargs rm -rf \
  && apt-get purge -y --auto-remove $buildDeps \
  && rm -rf $ERL_TOP /var/lib/apt/lists/*

Dockerfile.3elixir

FROM --platform=linux/amd64 my_app_erlang

ENV ELIXIR_VERSION="v1.14.5"

# Install Elixir
RUN set -xe \
  && ELIXIR_DOWNLOAD_URL="https://github.com/elixir-lang/elixir/archive/${ELIXIR_VERSION}.tar.gz" \
  && curl -fSL -o elixir-src.tar.gz $ELIXIR_DOWNLOAD_URL \
  && mkdir -p /usr/local/src/elixir \
  && tar -xzC /usr/local/src/elixir --strip-components=1 -f elixir-src.tar.gz \
  && rm elixir-src.tar.gz \
  && cd /usr/local/src/elixir \
&& make install clean

Dockerfile.4mix

# Use the base image with runtime libraries
FROM my_app_elixir as build

ENV REFRESHED_AT=2024-05-15

# set build ENV
ENV MIX_ENV=prod

# Set environment variables for the locale
RUN apt-get update

RUN apt-get install -y locales

RUN sed -i -e 's/# en_US.UTF-8 UTF-8/en_US.UTF-8 UTF-8/' /etc/locale.gen && \
    dpkg-reconfigure --frontend=noninteractive locales && \
    update-locale LANG=en_US.UTF-8

ENV LANG en_US.UTF-8
ENV LANGUAGE en_US:en
ENV LC_ALL en_US.UTF-8

# Install Node.js and Yarn for assets building
RUN curl -fsSL https://deb.nodesource.com/setup_16.x | bash - && \
    apt-get install -y nodejs && \
    npm install -g yarn && \
    apt-get clean && rm -rf /var/lib/apt/lists/*

# Prepare the build directory for Yarn dependencies
# WORKDIR /app/assets

# Copy package.json and yarn.lock to install dependencies
# COPY assets/package.json assets/yarn.lock ./

# Install Yarn dependencies
# RUN yarn install

# Prepare the build directory for the application code
WORKDIR /app

# install hex + rebar
RUN mix local.hex --force && \
    mix local.rebar --force

CMD ["/bin/bash"]

bin/dockerfile_release_config

#!/usr/bin/env bash

set -e

cd /app

# APP_NAME="$(grep 'app:' mix.exs | sed -e 's/\[//g' -e 's/ //g' -e 's/app://' -e 's/[:,]//g')"
# APP_VSN="$(grep 'version:' mix.exs | cut -d '"' -f2)"

export MIX_ENV=prod

# Fetch deps and compile

# Following change is done due to frequent timeouts
# mix deps.get --only prod
HEX_HTTP_CONCURRENCY=1 HEX_HTTP_TIMEOUT=120 mix deps.get --only prod

# Run an explicit clean to remove any build artifacts from the host
mix do clean, compile --force

cd assets
yarn install --ignore-optional && node build.js --deploy
cd ..

mix phx.digest

# Generate the release
mix release

exit 0

Commands run:

env /usr/bin/arch -x86_64 /bin/zsh --login

export DOCKER_DEFAULT_PLATFORM=linux/amd64 && \
docker build --platform=linux/amd64 -t my_app_ubuntu -f Dockerfile.1ubuntu .

export DOCKER_DEFAULT_PLATFORM=linux/amd64 && \
docker build --platform=linux/amd64 -t my_app_erlang -f Dockerfile.2erlang .

export DOCKER_DEFAULT_PLATFORM=linux/amd64 && \
docker build --platform=linux/amd64 -t my_app_elixir -f Dockerfile.3elixir .

export DOCKER_DEFAULT_PLATFORM=linux/amd64 && \
docker build --platform=linux/amd64 -t my_app_mix -f Dockerfile.4mix .


export DOCKER_DEFAULT_PLATFORM=linux/amd64 && \
docker run -v $(pwd):/app -v /app/priv/static/ -v /app/assets/node_modules/ --rm --name my_app_app -it my_app_mix:latest /app/bin/dockerfile_release_config

Then I rsync the genereated release to production server and start the server.

other changes made:

config/config.exs

...

config :dart_sass,
  version: "1.77.0",
  default: [
    args: ~w(css/app.scss ../priv/static/assets/app.css),
    cd: Path.expand("../assets", __DIR__)
  ]

# Configure esbuild (the version is required)
config :esbuild,
  version: "0.16.17",
  default: [
    args:
      ~w(js/app.js --bundle --target=es2019 --outdir=../priv/static/assets --external:/fonts/* --external:/images/*),
    cd: Path.expand("../assets", __DIR__),
    env: %{"NODE_PATH" => Path.expand("../deps", __DIR__)}
  ]

...

build.js

const esbuild = require("esbuild");
const sassPlugin = require("esbuild-sass-plugin").default;
const postcss = require('postcss')
const autoprefixer = require('autoprefixer')
const postcssPresetEnv = require('postcss-preset-env')
const copyStaticFiles = require('esbuild-copy-static-files')

const args = process.argv.slice(2);
const watch = args.includes('--watch');
const deploy = args.includes('--deploy');

const loader = {
  // Add loaders for images/fonts/etc, e.g. { '.svg': 'file' }
  ".woff": "copy",
  ".woff2": "copy",
  ".eot": "copy",
  ".ttf": "copy",
  ".svg": "copy",
  ".png": "copy",
  ".jpg": "copy",
  ".jpeg": "copy",
  ".gif": "copy",
  ".ico": "copy"
}

const plugins = [
  // Add and configure plugins here
  sassPlugin({
    async transform(source, resolveDir) {
      // const {css} = await postcss([autoprefixer, postcssPresetEnv({stage: 1})]).process(source, {from: filePath, to: 'assets/css/app.css'})
      const {css} = await postcss([autoprefixer, postcssPresetEnv({stage: 1})]).process(source, { from: undefined })
      return css
    }
  }),
  copyStaticFiles({
    src: './fonts',
    dest: '../priv/static/fonts',
    dereference: true,
    errorOnExist: false,
    filter: function () { return true },
    preserveTimestamps: true,
    recursive: true
  }),
  copyStaticFiles({
    src: './images',
    dest: '../priv/static/images',
    dereference: true,
    errorOnExist: false,
    filter: function () { return true },
    preserveTimestamps: true,
    recursive: true
  }),
  copyStaticFiles({
    src: './favicon.ico',
    dest: '../priv/static/favicon.ico',
    dereference: true,
    errorOnExist: false,
    filter: function () { return true },
    preserveTimestamps: true,
    recursive: true
  }),
  copyStaticFiles({
    src: './robots.txt',
    dest: '../priv/static/robots.txt',
    dereference: true,
    errorOnExist: false,
    filter: function () { return true },
    preserveTimestamps: true,
    recursive: true
  })
]

// Define esbuild options
let opts = {
  entryPoints: [
    'js/app.js',
    'js/bootstrap.js',
    'js/popper.js',
    'css/app.scss'
  ],
  // entryNames: '[dir]/[name]-[hash]',
  entryNames: '[dir]/[name]',
  bundle: true,
  logLevel: "info",
  target: "es2019",
  outdir: "../priv/static/assets",
  // external: ["*.css", "fonts/*", "images/*"],
  // nodePaths: ["../deps"],
  loader,
  plugins
};

if (watch) {
  opts = {
    ...opts,
    watch,
    sourcemap: 'inline'
  }
}

if (deploy) {
  opts = {
    ...opts,
    minify: true
  }
}

const promise = esbuild.build(opts)

if (watch) {
  promise.then(_result => {
    process.stdin.on('close', () => {
      process.exit(0)
    })

    process.stdin.resume()
  })
}

my_app_web.ex

...

def static_paths, do: ~w(assets fonts images favicon.ico robots.txt)

...

One of the guess work could be some changes need to be done for verified routes… may be

Any help is much appreciated.

Best regards,
Gorav