Compare commits

...
Author SHA1 Message Date
bytestream 64df8f2d71 don't swallow failures 2026-06-05 13:20:02 -07:00
bytestream 4fd2dee826 Fix sshd service missing on resolute 2026-06-05 13:20:02 -07:00
copilot-swe-agent[bot] 86cf8202b5 Name release output truncation constant 2026-06-02 10:09:00 -07:00
copilot-swe-agent[bot] d03b6e0747 Sanitize release warning output in scheduled workflow 2026-06-02 10:09:00 -07:00
copilot-swe-agent[bot] 1b42e4a722 Improve release warning diagnostics in scheduled build 2026-06-02 10:09:00 -07:00
copilot-swe-agent[bot] 1cf1a20fea Improve readability of release permission detection 2026-06-02 10:09:00 -07:00
copilot-swe-agent[bot] 4abf322a1e Deduplicate release permission warning in workflow 2026-06-02 10:09:00 -07:00
copilot-swe-agent[bot] f9ad45439e Refine scheduled release failure annotations 2026-06-02 10:09:00 -07:00
copilot-swe-agent[bot] 9ff063bf6d Clarify permission error condition in scheduled build 2026-06-02 10:09:00 -07:00
copilot-swe-agent[bot] ea94d20ef3 Improve gh release permission failure handling 2026-06-02 10:09:00 -07:00
copilot-swe-agent[bot] 784dc69f1e Harden release permission error detection in scheduled build 2026-06-02 10:09:00 -07:00
copilot-swe-agent[bot] cb4384832b Handle release creation permission errors in scheduled build 2026-06-02 10:09:00 -07:00
copilot-swe-agent[bot] dd4a993654 Fix indentation in scheduled build workflow 2026-06-02 09:40:26 -07:00
Jeshua Ben JosephandCopilot Autofix powered by AI 831fbc2060 Potential fix for pull request finding
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
2026-06-02 09:31:47 -07:00
copilot-swe-agent[bot] 3e6f99e74c Fix scheduled-build release tag parsing 2026-06-02 09:31:47 -07:00
Houssem eXo 4a0a4053ae Fix weekly release builds
- Fix quote handling in gh release list output
- Gracefully skip tracks without existing releases
- Increase release search limit to 100
- Add conditional checks to subsequent steps
2026-06-02 09:14:59 -07:00
PikachuEXE 113d19ac83 Merge pull request #661 from phusion/copilot/update-docs-ubuntu-26-04-rust
Document Ubuntu 26.04 Rust Coreutils & sudo-rs changes, add GNU fallback build flag
2026-05-21 17:40:16 +08:00
PikachuEXE 7690903458 Apply suggestion from @PikachuEXE 2026-05-21 13:26:59 +08:00
Jeshua Ben JosephandCopilot Autofix powered by AI 517ec715c9 Potential fix for pull request finding
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
2026-05-20 22:20:47 -07:00
PikachuEXE 7580639503 ~ Update README to remove most reference to sudo 2026-05-21 08:50:31 +08:00
PikachuEXE 785d124a70 Update scripts to really replace rust coreutils with GNU coreutils 2026-05-20 16:12:29 +08:00
copilot-swe-agent[bot]andTheaxiom af5f71b4d4 docs: rewrite speculative Dockerfile snippet with apt-cache discovery step
Agent-Logs-Url: https://github.com/phusion/baseimage-docker/sessions/dda28199-53b3-47bb-acf4-8aec529f3e22

Co-authored-by: Theaxiom <57013+Theaxiom@users.noreply.github.com>
2026-05-20 03:51:28 +00:00
Jeshua Ben JosephandCopilot Autofix powered by AI 86c83533b6 Potential fix for pull request finding
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
2026-05-18 14:10:38 -07:00
copilot-swe-agent[bot]andTheaxiom 9e1c46489b fix: address review feedback on prepare.sh verification and README codename
Agent-Logs-Url: https://github.com/phusion/baseimage-docker/sessions/f25d0dfd-2691-466f-8dcc-1075a4824daf

Co-authored-by: Theaxiom <57013+Theaxiom@users.noreply.github.com>
2026-05-18 21:00:15 +00:00
Jeshua Ben JosephandCopilot Autofix powered by AI e08fc42a89 Potential fix for pull request finding
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
2026-05-18 13:57:31 -07:00
Jeshua Ben JosephandCopilot Autofix powered by AI 1fb3ce0c68 Potential fix for pull request finding
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
2026-05-18 13:57:19 -07:00
copilot-swe-agent[bot]andTheaxiom 1a930ec955 docs: document Ubuntu 26.04 Rust Coreutils and sudo-rs, add INSTALL_GNU_COREUTILS build flag
Agent-Logs-Url: https://github.com/phusion/baseimage-docker/sessions/065ff4d3-d584-4cb8-8265-5d1f0f7dc3b1

Co-authored-by: Theaxiom <57013+Theaxiom@users.noreply.github.com>
2026-05-18 20:50:29 +00:00
copilot-swe-agent[bot] 169e147321 Initial plan 2026-05-18 20:46:06 +00:00
Houssem eXo 8128153b6f Add Ubuntu 26.04 "Resolute" as a supported base image track alongside the existing Noble (24.04) and Jammy (22.04) tracks.
Changes:

main.yml: add resolute-* tag prefix → ubuntu:26.04 mapping
scheduled-build.yml: add Resolute matrix entry to weekly security rebuild
prepare.sh: handle DEB822 .sources format (used by Ubuntu 24.04+) alongside legacy sources.list for universe/multiverse activation
README.md: update component table to reflect multi-track support
2026-05-18 13:44:07 -07:00
Skyler Mäntysaari f5be954731 Add GitHub auth status check step
Add step to check GitHub authentication status before creating a release.
2026-03-15 08:01:19 +02:00
Copilotandsamip5 c75696af2a Fix HTTP 403 on gh release create by adding workflow-level permissions (#654)
* Fix HTTP 403 when creating GitHub releases by adding workflow-level permissions

Co-authored-by: samip5 <1703002+samip5@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: samip5 <1703002+samip5@users.noreply.github.com>
2026-02-27 15:59:39 +02:00
Copilotandsamip5 c662980686 Add GitHub releases with patch version bumps for scheduled security builds (#653)
- scheduled-build.yml: Create GitHub release after each weekly security
  rebuild with date-stamped tag (e.g. noble-1.0.2-security.20260227)
- scheduled-build.yml: Add date-stamped Docker image tags alongside
  existing version and codename tags
- scheduled-build.yml: Bump permissions to contents:write for release
  creation
- scheduled-build.yml: Exclude security-tagged releases from base
  version lookup to prevent nested tags
- main.yml: Update docker/build-push-action from v5 to v6
- scheduled-build.yml: Update docker/build-push-action from v5 to v6
- stale.yml: Remove deprecated repo-token parameter

Co-authored-by: samip5 <1703002+samip5@users.noreply.github.com>

* Replace security date tags with patch version bumps in scheduled builds

The scheduled weekly security build now bumps the patch version
(e.g. noble-1.0.2 -> noble-1.0.3) instead of appending
-security.YYYYMMDD. Each rebuild creates a proper GitHub release
with the new patch tag and pushes Docker images accordingly.

Co-authored-by: samip5 <1703002+samip5@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: samip5 <1703002+samip5@users.noreply.github.com>
2026-02-27 15:27:06 +02:00
CopilotandTheaxiom 44a761d9eb Automated weekly security rebuilds for all active Ubuntu LTS tracks (#652)
* Add scheduled security builds for multiple LTS tracks (jammy + noble)

Co-authored-by: Theaxiom <57013+Theaxiom@users.noreply.github.com>

* Address review feedback: checkout at release tag, exclude pre-releases/drafts, warn on unknown tag prefix

Co-authored-by: Theaxiom <57013+Theaxiom@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Theaxiom <57013+Theaxiom@users.noreply.github.com>
2026-02-27 13:01:16 +02:00
Jeshua Ben Joseph 2403c58254 noble-1.0.2 2025-04-10 01:22:40 -07:00
Emfox Zhou 1485f7c4e8 locale-gen on Debian does not take arguments and just read from /etc/locale.gen. (#648) 2025-03-15 09:43:41 +02:00
Jason N. White eb88d59d31 Update LICENSE.txt, fix license year (#647) 2025-01-01 13:38:29 +02:00
Pascal f627e59aaf Update README.md (#641)
Fix typo preventing installation of vagrant-disksize plugin.
2024-11-28 13:56:04 +02:00
Skyler Mäntysaari f3a14b25e9 Merge pull request #639 from MrSerth/master
* Upgrade to Ubuntu 24.04 Noble
* Update syslog-ng.conf to version 4.3
* Add default smart-multi-line.fsm config for syslog-ng

The config file is taken from the syslog-ng upstream repository. It got added for the syslog-ng 4.2.0 release and remained unchanged since then (as of April 2024).

https://github.com/syslog-ng/syslog-ng/blob/syslog-ng-4.2.0/lib/multi-line/smart-multi-line.fsm

* Use latest workflow run for release badge
2024-04-26 14:51:43 +03:00
Sebastian Serth 8b34e94fa3 Update GitHub actions to newest versions (#638)
These changes are required to use NodeJS 20 on GitHub.

https://github.blog/changelog/2023-09-22-github-actions-transitioning-from-node-16-to-node-20/
2024-04-21 00:00:58 +03:00
Sebastian Serth a2409df832 Use latest workflow run for release badge 2024-04-20 19:41:23 +02:00
Sebastian Serth 74cb590288 Add default smart-multi-line.fsm config for syslog-ng
The config file is taken from the syslog-ng upstream repository. It got added for the syslog-ng 4.2.0 release and remained unchanged since then (as of April 2024).

https://github.com/syslog-ng/syslog-ng/blob/syslog-ng-4.2.0/lib/multi-line/smart-multi-line.fsm
2024-04-20 19:41:23 +02:00
Sebastian Serth c2142db49c Update syslog-ng.conf to version 4.3 2024-04-20 19:41:23 +02:00
Sebastian Serth 5e90beeff5 Upgrade to Ubuntu 24.04 Noble 2024-04-20 19:41:23 +02:00
Sebastian Serth c17acec8ae Prevent 'invalid escape sequence' errors in newer Python versions (#637) 2024-04-20 02:45:27 +03:00
Timon de Groot 568883a7bf image/prepare: Check if container is actually ubuntu (#636) 2024-04-03 17:26:47 +03:00
Davide Palma 5c6b4e0cd3 readme: change ubuntu version (#635) 2024-03-20 17:58:38 +02:00
18 changed files with 452 additions and 45 deletions
+26 -6
View File
@@ -4,13 +4,18 @@ on:
workflow_dispatch:
release:
types: [published]
permissions:
contents: read
packages: write
jobs:
build:
runs-on: ubuntu-latest
if: "!contains(github.event.head_commit.message, '[ci-skip]')"
steps:
- name: Checkout
uses: actions/checkout@v2
uses: actions/checkout@v4
- name: Prepare
id: prep
@@ -21,6 +26,19 @@ jobs:
PLATFORMS=amd64,arm,arm64
TAGS="${DOCKER_IMAGE}:${GIT_BRANCH}, ghcr.io/${{ github.repository_owner }}/baseimage:${GIT_BRANCH}"
# Determine BASE_IMAGE from release tag prefix (e.g. noble-1.0.2 -> ubuntu:24.04)
if [[ "${GIT_BRANCH}" == resolute-* ]]; then
BASE_IMAGE="ubuntu:26.04"
elif [[ "${GIT_BRANCH}" == noble-* ]]; then
BASE_IMAGE="ubuntu:24.04"
elif [[ "${GIT_BRANCH}" == jammy-* ]]; then
BASE_IMAGE="ubuntu:22.04"
else
# Default to noble (latest LTS) for unrecognised tag prefixes
echo "::warning::Unrecognized release tag prefix '${GIT_BRANCH}'. Expected it to start with 'resolute-', 'noble-', or 'jammy-'. Defaulting BASE_IMAGE to ubuntu:24.04 (Noble)."
BASE_IMAGE="ubuntu:24.04"
fi
# Set output parameters.
if [ "${{github.event_name}}" == "pull_request" ]; then
@@ -32,15 +50,16 @@ jobs:
echo "docker_image=${DOCKER_IMAGE}" >> $GITHUB_OUTPUT
fi
echo "platforms=${PLATFORMS}" >> $GITHUB_OUTPUT
echo "base_image=${BASE_IMAGE}" >> $GITHUB_OUTPUT
- name: Set up QEMU
uses: docker/setup-qemu-action@v1
uses: docker/setup-qemu-action@v3
with:
platforms: ${{ steps.prep.outputs.platforms }}
- name: Login to GHCR (Github Container Registry)
uses: docker/login-action@v1
uses: docker/login-action@v3
if: github.event_name != 'pull_request'
with:
registry: ghcr.io
@@ -49,7 +68,7 @@ jobs:
- name: Set up Docker Buildx
id: buildx
uses: docker/setup-buildx-action@v1
uses: docker/setup-buildx-action@v3
with:
install: true
version: latest
@@ -58,16 +77,17 @@ jobs:
- name: Login to Docker Hub
if: github.event_name != 'pull_request'
uses: docker/login-action@v1
uses: docker/login-action@v3
with:
username: ${{ secrets.DOCKER_USERNAME }}
password: ${{ secrets.DOCKER_PASSWORD }}
- name: Build and Push
uses: docker/build-push-action@v2
uses: docker/build-push-action@v6
with:
builder: ${{ steps.buildx.outputs.name }}
context: image
platforms: ${{ steps.prep.outputs.platforms }}
push: ${{ steps.prep.outputs.push }}
tags: ${{ steps.prep.outputs.tags }}
build-args: BASE_IMAGE=${{ steps.prep.outputs.base_image }}
+180
View File
@@ -0,0 +1,180 @@
name: Scheduled Security Build
on:
schedule:
- cron: '0 2 * * 0' # Every Sunday at 02:00 UTC
workflow_dispatch:
permissions:
contents: write
packages: write
id-token: write
pull-requests: read
jobs:
build:
runs-on: ubuntu-latest
permissions:
contents: write
packages: write
id-token: write
pull-requests: read
strategy:
fail-fast: false
matrix:
include:
- ubuntu_codename: resolute
base_image: ubuntu:26.04
- ubuntu_codename: noble
base_image: ubuntu:24.04
- ubuntu_codename: jammy
base_image: ubuntu:22.04
steps:
- name: Get latest release tag and compute next patch version
id: release
run: |
LATEST_TAG=$(gh release list \
--repo ${{ github.repository }} \
--limit 100 \
--exclude-pre-releases \
--exclude-drafts \
--json tagName \
--jq "[.[] | select(.tagName | startswith(\"${{ matrix.ubuntu_codename }}-\"))] | first | .tagName // empty")
if [ -z "${LATEST_TAG}" ]; then
echo "No release found for ${{ matrix.ubuntu_codename }} track. Skipping."
echo "should_build=false" >> $GITHUB_OUTPUT
exit 0
fi
# Extract version and bump patch: noble-1.0.2 -> noble-1.0.3
if ! echo "${LATEST_TAG}" | grep -qE '^[a-z]+-[0-9]+\.[0-9]+\.[0-9]+$'; then
echo "Tag '${LATEST_TAG}' does not match expected format <codename>-<major>.<minor>.<patch>" >&2
exit 1
fi
PREFIX="${LATEST_TAG%.*}" # noble-1.0
PATCH="${LATEST_TAG##*.}" # 2
NEXT_PATCH=$((PATCH + 1))
NEXT_TAG="${PREFIX}.${NEXT_PATCH}" # noble-1.0.3
echo "current_tag=${LATEST_TAG}" >> $GITHUB_OUTPUT
echo "next_tag=${NEXT_TAG}" >> $GITHUB_OUTPUT
echo "should_build=true" >> $GITHUB_OUTPUT
env:
GH_TOKEN: ${{ github.token }}
- name: Checkout release tag
if: steps.release.outputs.should_build == 'true'
uses: actions/checkout@v4
with:
ref: ${{ steps.release.outputs.current_tag }}
- name: Prepare
if: steps.release.outputs.should_build == 'true'
id: prep
run: |
DOCKER_IMAGE=phusion/baseimage
NEXT_TAG=${{ steps.release.outputs.next_tag }}
PLATFORMS=amd64,arm,arm64
TAGS="${DOCKER_IMAGE}:${NEXT_TAG}"
TAGS="${TAGS}, ${DOCKER_IMAGE}:${{ matrix.ubuntu_codename }}"
TAGS="${TAGS}, ghcr.io/${{ github.repository_owner }}/baseimage:${NEXT_TAG}"
TAGS="${TAGS}, ghcr.io/${{ github.repository_owner }}/baseimage:${{ matrix.ubuntu_codename }}"
echo "tags=${TAGS}" >> $GITHUB_OUTPUT
echo "platforms=${PLATFORMS}" >> $GITHUB_OUTPUT
- name: Set up QEMU
if: steps.release.outputs.should_build == 'true'
uses: docker/setup-qemu-action@v3
with:
platforms: ${{ steps.prep.outputs.platforms }}
- name: Set up Docker Buildx
if: steps.release.outputs.should_build == 'true'
uses: docker/setup-buildx-action@v3
with:
install: true
version: latest
driver-opts: image=moby/buildkit:latest
- name: Login to GHCR (Github Container Registry)
if: steps.release.outputs.should_build == 'true'
uses: docker/login-action@v3
with:
registry: ghcr.io
username: ${{ github.actor }}
password: ${{ github.token }}
- name: Login to Docker Hub
if: steps.release.outputs.should_build == 'true'
uses: docker/login-action@v3
with:
username: ${{ secrets.DOCKER_USERNAME }}
password: ${{ secrets.DOCKER_PASSWORD }}
- name: Build and Push
if: steps.release.outputs.should_build == 'true'
uses: docker/build-push-action@v6
with:
context: image
platforms: ${{ steps.prep.outputs.platforms }}
push: true
tags: ${{ steps.prep.outputs.tags }}
build-args: BASE_IMAGE=${{ matrix.base_image }}
no-cache: true
- name: Check gh auth status
if: steps.release.outputs.should_build == 'true'
run: gh auth status
env:
GH_TOKEN: ${{ github.token }}
- name: Create GitHub Release
if: steps.release.outputs.should_build == 'true'
run: |
cat <<EOF > release_notes.md
Automated weekly security rebuild of \`${{ steps.release.outputs.current_tag }}\` with latest \`${{ matrix.base_image }}\` packages.
Images pushed:
- \`phusion/baseimage:${{ steps.release.outputs.next_tag }}\`
- \`phusion/baseimage:${{ matrix.ubuntu_codename }}\`
- \`ghcr.io/${{ github.repository_owner }}/baseimage:${{ steps.release.outputs.next_tag }}\`
- \`ghcr.io/${{ github.repository_owner }}/baseimage:${{ matrix.ubuntu_codename }}\`
EOF
set +e
GH_RELEASE_OUTPUT=$(gh release create "${{ steps.release.outputs.next_tag }}" \
--repo "${{ github.repository }}" \
--target "$(git rev-parse HEAD)" \
--title "${{ steps.release.outputs.next_tag }}" \
--notes-file release_notes.md 2>&1)
GH_RELEASE_EXIT_CODE=$?
set -e
if [ "${GH_RELEASE_EXIT_CODE}" -ne 0 ]; then
RELEASE_PERMISSION_WARNING="Skipping GitHub release creation for ${{ steps.release.outputs.next_tag }} because the workflow token cannot create releases."
IS_PERMISSION_DENIED=false
PERMISSION_PATTERN_MATCH=false
if echo "${GH_RELEASE_OUTPUT}" | grep -Eqi "HTTP 403|Resource not accessible by integration|permission|denied"; then
PERMISSION_PATTERN_MATCH=true
fi
if [ "${GH_RELEASE_EXIT_CODE}" -eq 4 ] || [ "${PERMISSION_PATTERN_MATCH}" = "true" ]; then
IS_PERMISSION_DENIED=true
fi
if [ "${IS_PERMISSION_DENIED}" = "true" ]; then
MAX_RELEASE_OUTPUT_SUMMARY_LENGTH=500
GH_RELEASE_OUTPUT_SINGLE_LINE="${GH_RELEASE_OUTPUT//$'\n'/ }"
GH_RELEASE_OUTPUT_SUMMARY="${GH_RELEASE_OUTPUT_SINGLE_LINE:0:${MAX_RELEASE_OUTPUT_SUMMARY_LENGTH}}"
echo "::warning::${RELEASE_PERMISSION_WARNING}. gh output: ${GH_RELEASE_OUTPUT_SUMMARY}"
else
echo "::error::${GH_RELEASE_OUTPUT}"
exit ${GH_RELEASE_EXIT_CODE}
fi
else
echo "${GH_RELEASE_OUTPUT}"
fi
env:
GH_TOKEN: ${{ github.token }}
+1 -2
View File
@@ -7,9 +7,8 @@ jobs:
stale:
runs-on: ubuntu-latest
steps:
- uses: actions/stale@v3
- uses: actions/stale@v9
with:
repo-token: ${{ secrets.GITHUB_TOKEN }}
stale-issue-message: 'This Issue has been automatically marked as "stale" because it has not had recent activity (for 15 days). It will be closed if no further activity occurs. Thanks for the feedback.'
stale-pr-message: 'This Pull Request has been automatically marked as "stale" because it has not had recent activity (for 15 days). It will be closed if no further activity occurs. Thank you for your contribution.'
close-issue-message: 'Due to the lack of activity in the last 5 days since it was marked as "stale", we proceed to close this Issue. Do not hesitate to reopen it later if necessary.'
+1 -1
View File
@@ -1,4 +1,4 @@
Copyright (c) 2013-2015 Phusion Holding B.V.
Copyright (c) 2013-2025 Phusion Holding B.V.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
+1 -1
View File
@@ -1,4 +1,4 @@
VERSION ?= focal-1.0.0-pre
VERSION ?= noble-1.0.2
ifdef BASE_IMAGE
BUILD_ARG = --build-arg BASE_IMAGE=$(BASE_IMAGE)
ifndef NAME
+58 -4
View File
@@ -1,6 +1,6 @@
# A minimal Ubuntu base image modified for Docker-friendliness
[![Release](https://github.com/phusion/baseimage-docker/actions/workflows/main.yml/badge.svg?branch=focal-1.1.0)](https://github.com/phusion/baseimage-docker/actions/workflows/main.yml)
[![Release](https://github.com/phusion/baseimage-docker/actions/workflows/main.yml/badge.svg)](https://github.com/phusion/baseimage-docker/actions/workflows/main.yml)
_Baseimage-docker only consumes 8.3 MB RAM and is much more powerful than Busybox or Alpine. See why below._
@@ -71,7 +71,8 @@ You can configure the stock `ubuntu` image yourself from your Dockerfile, so why
* [Using your own key](#using_your_own_key)
* [The `docker-ssh` tool](#docker_ssh)
* [Building the image yourself](#building)
* [Removing optional services](#removing_optional_services)
* [Removing optional services](#removing_optional_services)
* [Ubuntu 26.04 LTS: Rust Coreutils](#ubuntu_2604_rust)
* [Conclusion](#conclusion)
-----------------------------------------
@@ -86,7 +87,7 @@ You can configure the stock `ubuntu` image yourself from your Dockerfile, so why
| Component | Why is it included? / Remarks |
| ---------------- | ------------------- |
| Ubuntu 20.04 LTS | The base system. |
| Ubuntu 26.04 LTS (Resolute) or 24.04 LTS (Noble) | The base system. Ubuntu 26.04 "Resolute" is the latest LTS; 24.04 "Noble" and 22.04 "Jammy" tracks are also maintained. **Note:** Ubuntu 26.04 ships [Rust Coreutils (uutils coreutils)](#ubuntu_2604_rust) instead of GNU Coreutils. See the [dedicated section](#ubuntu_2604_rust) for details and alternatives. |
| A **correct** init process | _Main article: [Docker and the PID 1 zombie reaping problem](http://blog.phusion.nl/2015/01/20/docker-and-the-pid-1-zombie-reaping-problem/)._ <br><br>According to the Unix process model, [the init process](https://en.wikipedia.org/wiki/Init) -- PID 1 -- inherits all [orphaned child processes](https://en.wikipedia.org/wiki/Orphan_process) and must [reap them](https://en.wikipedia.org/wiki/Wait_(system_call)). Most Docker containers do not have an init process that does this correctly. As a result, their containers become filled with [zombie processes](https://en.wikipedia.org/wiki/Zombie_process) over time. <br><br>Furthermore, `docker stop` sends SIGTERM to the init process, which stops all services. Unfortunately most init systems don't do this correctly within Docker since they're built for hardware shutdowns instead. This causes processes to be hard killed with SIGKILL, which doesn't give them a chance to correctly deinitialize things. This can cause file corruption. <br><br>Baseimage-docker comes with an init process `/sbin/my_init` that performs both of these tasks correctly. |
| Fixes APT incompatibilities with Docker | See https://github.com/dotcloud/docker/issues/1024. |
| syslog-ng | A syslog daemon is necessary so that many services - including the kernel itself - can correctly log to /var/log/syslog. If no syslog daemon is running, a lot of important messages are silently swallowed. <br><br>Only listens locally. All syslog messages are forwarded to "docker logs".<br><br>Why syslog-ng?<br>I've had bad experience with rsyslog. I regularly run into bugs with rsyslog, and once in a while it takes my log host down by entering a 100% CPU loop in which it can't do anything. Syslog-ng seems to be much more stable. |
@@ -586,7 +587,7 @@ Start a virtual machine with Docker in it. You can use the Vagrantfile that we'v
First, install `vagrant-disksize` plug-in:
vagrant plugin install vagrant-disksize:
vagrant plugin install vagrant-disksize
Then, start the virtual machine
@@ -636,6 +637,59 @@ You can also set them directly as shown in the following example, to prevent `ss
Then you can proceed with `make build` command.
<a name="ubuntu_2604_rust"></a>
### Ubuntu 26.04 LTS: Rust Coreutils
Ubuntu 26.04 LTS introduced two significant changes compared to earlier Ubuntu releases:
1. **Rust Coreutils (`uutils coreutils`)** — Ubuntu 26.04 ships [uutils coreutils](https://github.com/uutils/coreutils), a Rust-based reimplementation of the GNU Core Utilities (`ls`, `cp`, `mv`, `cat`, etc.), as the default `coreutils` package. This replaces the traditional [GNU Coreutils](https://www.gnu.org/software/coreutils/).
2. **sudo-rs** — Ubuntu 26.04 ships [sudo-rs](https://github.com/trifectatechfoundation/sudo-rs), a memory-safe Rust reimplementation of `sudo`, as the default `sudo` provider. (This is absent in official Docker image)
#### Why this matters
| Concern | Details |
|---------|---------|
| **Compatibility** | `uutils coreutils` aims for GNU Coreutils compatibility but may have subtle behavioral differences that can break scripts relying on specific GNU flags or output formats. Test your Dockerfiles and scripts carefully when upgrading to the 26.04 base image. |
| **Security** | Rust's memory-safety guarantees eliminate whole classes of memory-related vulnerabilities (buffer overflows, use-after-free, etc.). This is generally considered an improvement for security. However, the Rust implementations are newer and have had less real-world exposure than their GNU counterparts. |
| **Licensing** | `uutils coreutils` and GNU Coreutils are licensed under different terms: `uutils coreutils` uses the **MIT license**, whereas GNU Coreutils is **GPL-3.0**. Users or organizations with specific license requirements should review these changes. |
| **Maturity** | `uutils coreutils` is a newer project. Some edge cases, rarely-used options, or locale-sensitive behavior may differ from the GNU originals. |
#### Alternatives
**Option 1: Use the Ubuntu 24.04 LTS base image (recommended if you need GNU tooling)**
The 24.04 "Noble Numbat" track is fully supported and ships GNU Coreutils:
```Dockerfile
FROM phusion/baseimage:noble-1.0.2
```
Or build the image yourself targeting Ubuntu 24.04:
```bash
make build BASE_IMAGE=ubuntu:24.04
```
**Option 2: Replace Rust Coreutils with GNU Coreutils on Ubuntu 26.04**
When building baseimage-docker from source, you can set `INSTALL_GNU_COREUTILS=1` to replace `uutils coreutils` with GNU Coreutils:
```bash
docker build --build-arg BASE_IMAGE=ubuntu:26.04 --build-arg INSTALL_GNU_COREUTILS=1 image/
```
Alternatively, you can install GNU Coreutils in your own Dockerfile that derives from a 26.04-based baseimage by removing `uutils coreutils`:
```Dockerfile
FROM phusion/baseimage:<ubuntu-26.04-version>
# Replace uutils coreutils with GNU Coreutils.
RUN apt-get update && \
apt-get remove -y --allow-remove-essential coreutils-from-uutils && \
apt-get clean && rm -rf /var/lib/apt/lists/*
```
<a name="conclusion"></a>
## Conclusion
+1 -1
View File
@@ -82,7 +82,7 @@ Baseimage-docker让这一切完美。在"内容"部分描述了所有这些修
| 模块 | 为什么包含这些?以及备注 |
| ---------------- | ------------------- |
| Ubuntu 20.04 LTS | 基础系统。 |
| Ubuntu 24.04 LTS | 基础系统。 |
| 一个**正确**的初始化进程 | *主要文章:[Docker和PID 1 僵尸进程回收问题](http://blog.phusion.nl/2015/01/20/docker-and-the-pid-1-zombie-reaping-problem/)*<br/><br/>根据Unix进程模型,[初始化进程](https://en.wikipedia.org/wiki/Init) -- PID 1 -- 继承了所有[孤立的子进程](https://en.wikipedia.org/wiki/Orphan_process),并且必须[进行回收](https://en.wikipedia.org/wiki/Wait_(system_call))。大多数Docker容器没有一个初始化进程可以正确的完成此操作,随着时间的推移会导致他们的容器出现了大量的[僵尸进程](https://en.wikipedia.org/wiki/Zombie_process)。<br/><br/>而且,`docker stop`发送SIGTERM信号给初始化进程,照理说此信号应该可以停止所有服务。不幸的是由于它们对硬件进行了关闭操作,导致Docker内的大多数初始化系统没有正确执行。这会导致进程强行被SIGKILL信号关闭,从而丧失了一个正确取消初始化设置的机会。这会导致文件损坏。<br/><br/>Baseimage-docker配有一个名为`/sbin/my_init`的初始化进程来同时正确的完成这些任务。 |
| 修复了APT与Docker不兼容的问题 | 详情参见:https://github.com/dotcloud/docker/issues/1024 。 |
| syslog-ng | 对于很多服务-包括kernel自身,都需要一个syslog后台进程,以便可以正确的将log输出到/var/log/syslog中。如果没有运行syslog后台进程,很多重要的信息就会默默的丢失了。<br/><br/>只对本地进行监听。所有syslog信息会被转发给“docker logs”。 |
+1 -1
View File
@@ -82,7 +82,7 @@ Baseimage-docker讓這一切完美。在"內容"部分描述了所有這些修
| 模塊 | 爲什麼包含這些?以及備註 |
| ---------------- | ------------------- |
| Ubuntu 20.04 LTS | 基礎系統。 |
| Ubuntu 24.04 LTS | 基礎系統。 |
| 一個**正確**的初始化行程 | *主要文章:[Docker和PID 1 殭屍行程回收問題](http://blog.phusion.nl/2015/01/20/docker-and-the-pid-1-zombie-reaping-problem/)*<br/><br/>根據Unix行程模型,[初始化行程](https://en.wikipedia.org/wiki/Init) -- PID 1 -- 繼承了所有[孤立的子行程](https://en.wikipedia.org/wiki/Orphan_process),並且必須[進行回收](https://en.wikipedia.org/wiki/Wait_(system_call))。大多數Docker容器沒有一個初始化行程可以正確的完成此操作,隨着時間的推移會導致他們的容器出現了大量的[殭屍行程](https://en.wikipedia.org/wiki/Zombie_process)。<br/><br/>而且,`docker stop`發送SIGTERM信號給初始化行程,照理說此信號應該可以停止所有服務。不幸的是由於它們對硬體進行了關閉操作,導致Docker內的大多數初始化系統沒有正確執行。這會導致行程強行被SIGKILL信號關閉,從而喪失了一個正確取消初始化設置的機會。這會導致文件損壞。<br/><br/>Baseimage-docker配有一個名爲`/sbin/my_init`的初始化行程來同時正確的完成這些任務。 |
| 修復了APT與Docker不兼容的問題 | 詳情參見:https://github.com/dotcloud/docker/issues/1024 。 |
| syslog-ng | 對於很多服務-包括kernel自身,都需要一個syslog後臺行程,以便可以正確的將log輸出到/var/log/syslog中。如果沒有運行syslog後臺行程,很多重要的信息就會默默的丟失了。<br/><br/>只對本地進行監聽。所有syslog信息會被轉發給“docker logs”。 |
Vendored
+1 -2
View File
@@ -12,7 +12,7 @@ Vagrant.configure("2") do |config|
# Every Vagrant development environment requires a box. You can search for
# boxes at https://atlas.hashicorp.com/search.
config.vm.box = "ubuntu/focal64"
config.vm.box = "ubuntu/noble64"
config.disksize.size = '50GB'
# Disable automatic box update checking. If you disable this, then
@@ -72,4 +72,3 @@ Vagrant.configure("2") do |config|
config.vm.provision :shell,
path: "vagrant-libs/bootstrap.sh"
end
+7 -2
View File
@@ -1,12 +1,17 @@
ARG BASE_IMAGE=ubuntu:22.04
ARG BASE_IMAGE=ubuntu:24.04
FROM $BASE_IMAGE
ARG QEMU_ARCH
#ADD x86_64_qemu-${QEMU_ARCH}-static.tar.gz /usr/bin
# Ubuntu 26.04+ ships uutils-coreutils (Rust) by default.
# Set INSTALL_GNU_COREUTILS=1 to replace them with GNU Coreutils.
# Has no effect on Ubuntu releases prior to 26.04.
ARG INSTALL_GNU_COREUTILS=0
COPY . /bd_build
RUN /bd_build/prepare.sh && \
RUN INSTALL_GNU_COREUTILS=$INSTALL_GNU_COREUTILS /bd_build/prepare.sh && \
/bd_build/system_services.sh && \
/bd_build/utilities.sh && \
/bd_build/cleanup.sh
+2 -2
View File
@@ -22,7 +22,7 @@ LOG_LEVEL_WARN = 1
LOG_LEVEL_INFO = 2
LOG_LEVEL_DEBUG = 3
SHENV_NAME_WHITELIST_REGEX = re.compile('\W')
SHENV_NAME_WHITELIST_REGEX = re.compile(r'\W')
log_level = None
@@ -93,7 +93,7 @@ def import_envvars(clear_existing_environment=True, override_existing_environmen
# Text files often end with a trailing newline, which we
# don't want to include in the env variable value. See
# https://github.com/phusion/baseimage-docker/pull/49
value = re.sub('\n\Z', '', f.read())
value = re.sub('\n\\Z', '', f.read())
new_env[name] = value
if clear_existing_environment:
os.environ.clear()
+5
View File
@@ -7,3 +7,8 @@ minimal_apt_get_install='apt-get install -y --no-install-recommends'
export DISABLE_SYSLOG=${DISABLE_SYSLOG:-0}
export DISABLE_SSH=${DISABLE_SSH:-0}
export DISABLE_CRON=${DISABLE_CRON:-0}
# Ubuntu 26.04+ ships uutils-coreutils (Rust) by default.
# Set INSTALL_GNU_COREUTILS=1 to replace them with GNU Coreutils.
# Has no effect on Ubuntu releases prior to 26.04.
export INSTALL_GNU_COREUTILS=${INSTALL_GNU_COREUTILS:-0}
+58 -3
View File
@@ -11,9 +11,24 @@ mkdir -p /etc/container_environment
echo -n no > /etc/container_environment/INITRD
## Enable Ubuntu Universe, Multiverse, and deb-src for main.
sed -i 's/^#\s*\(deb.*main restricted\)$/\1/g' /etc/apt/sources.list
sed -i 's/^#\s*\(deb.*universe\)$/\1/g' /etc/apt/sources.list
sed -i 's/^#\s*\(deb.*multiverse\)$/\1/g' /etc/apt/sources.list
if grep -E '^ID=' /etc/os-release | grep -q ubuntu; then
UBUNTU_VERSION=$(grep '^VERSION_ID=' /etc/os-release | cut -d'"' -f2)
# Ubuntu 24.04+ uses DEB822 format (.sources files); older releases use sources.list
if dpkg --compare-versions "$UBUNTU_VERSION" ge "24.04" 2>/dev/null && \
compgen -G '/etc/apt/sources.list.d/*.sources' > /dev/null; then
# DEB822 format: enable universe and multiverse components
for f in /etc/apt/sources.list.d/*.sources; do
sed -i 's/^Components: main$/Components: main restricted universe multiverse/' "$f"
sed -i 's/^Components: main restricted$/Components: main restricted universe multiverse/' "$f"
done
else
# Legacy sources.list format (Ubuntu < 24.04)
sed -i 's/^#\s*\(deb.*main restricted\)$/\1/g' /etc/apt/sources.list
sed -i 's/^#\s*\(deb.*universe\)$/\1/g' /etc/apt/sources.list
sed -i 's/^#\s*\(deb.*multiverse\)$/\1/g' /etc/apt/sources.list
fi
fi
apt-get update
## Fix some issues with APT packages.
@@ -40,6 +55,45 @@ $minimal_apt_get_install software-properties-common
## Upgrade all packages.
apt-get dist-upgrade -y --no-install-recommends -o Dpkg::Options::="--force-confold"
## Ubuntu 26.04+ ships uutils-coreutils (Rust) by default.
## Optionally replace them with GNU Coreutils when
## INSTALL_GNU_COREUTILS=1 is set at build time.
if grep -E '^ID=' /etc/os-release | grep -q ubuntu; then
UBUNTU_VERSION=$(grep '^VERSION_ID=' /etc/os-release | cut -d'"' -f2)
if dpkg --compare-versions "$UBUNTU_VERSION" ge "26.04" 2>/dev/null; then
case "${INSTALL_GNU_COREUTILS:-0}" in
0|1)
INSTALL_GNU_COREUTILS_NORMALIZED="${INSTALL_GNU_COREUTILS:-0}"
;;
*)
echo "*** Invalid value for INSTALL_GNU_COREUTILS: '${INSTALL_GNU_COREUTILS}'" >&2
echo "*** Expected 0 or 1." >&2
exit 1
;;
esac
if [ "$INSTALL_GNU_COREUTILS_NORMALIZED" = "1" ]; then
echo "*** Removing Rust to restore GNU Coreutils..."
# GNU Coreutils can only be installed by removing `coreutils-from-uutils`
apt-get remove -y --allow-remove-essential coreutils-from-uutils
# Verify that GNU coreutils are now the active implementation on PATH.
# Some packages may install binaries under a non-default path and rely on
# update-alternatives; if so the replacement has not taken effect.
if ! ls --version 2>&1 | grep -qi 'gnu coreutils'; then
echo "*** ERROR: coreutils-from-gnu was installed but GNU coreutils are not active on PATH." >&2
echo "*** 'ls --version' does not report 'GNU coreutils'." >&2
echo "*** The package may place binaries outside the default PATH or require" >&2
echo "*** manual update-alternatives configuration. Check Ubuntu 26.04 packaging." >&2
exit 1
fi
LS_VER=$(ls --version | head -1)
echo "*** GNU Coreutils are active ($LS_VER)."
else
echo "*** Ubuntu 26.04 detected: using default uutils-coreutils (Rust)."
echo "*** Set INSTALL_GNU_COREUTILS=1 at build time to use GNU Coreutils instead."
fi
fi
fi
## Fix locale.
case $(lsb_release -is) in
Ubuntu)
@@ -47,6 +101,7 @@ case $(lsb_release -is) in
;;
Debian)
$minimal_apt_get_install locales locales-all
echo "en_US.UTF-8 UTF-8" >> /etc/locale.gen
;;
*)
;;
+2 -2
View File
@@ -7,8 +7,8 @@ SSHD_BUILD_PATH=/bd_build/services/sshd
## Install the SSH server.
$minimal_apt_get_install openssh-server
mkdir /var/run/sshd
mkdir /etc/service/sshd
mkdir -p /var/run/sshd
mkdir -p /etc/service/sshd
touch /etc/service/sshd/down
cp $SSHD_BUILD_PATH/sshd.runit /etc/service/sshd/run
cp $SSHD_BUILD_PATH/sshd_config /etc/ssh/sshd_config
@@ -0,0 +1,83 @@
#
# Copyright 2023 Balazs Scheidler
# Copyright 2016 Google Inc. All rights reserved.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
# The regular expressions were extracted from
# https://github.com/GoogleCloudPlatform/fluent-plugin-detect-exceptions
# and converted into a TSV format by Balazs Scheidler.
#
# List of tab separated fields
#
# comma-separated-states /regexp/ new_state
#
# java
start_state,java_start_exception /(?:Exception|Error|Throwable|V8 errors stack trace)[:\r\n]/ java_after_exception
java_after_exception /^[\t ]*nested exception is:[\t ]*/ java_start_exception
java_after_exception /^[\r\n]*$/ java_after_exception
java_after_exception,java /^[\t ]+(?:eval )?at / java
java_after_exception,java /^[\t ]+--- End of inner exception stack trace ---$/ java
java_after_exception,java /^--- End of stack trace from previous location where exception was thrown ---$/ java
java_after_exception,java /^[\t ]*(?:Caused by|Suppressed):/ java_after_exception
java_after_exception,java /^[\t ]*... \d+ (?:more|common frames omitted)/ java
# python
start_state /^Traceback \(most recent call last\):$/ python
python /^[\t ]*File / python_code
python_code /[^\t ]/ python
python /^(?:[^\s.():]+\.)*[^\s.():]+:/ start_state
# PHP
start_state /(?:PHP\ (?:Notice|Parse\ error|Fatal\ error|Warning):)|(?:exception\ '[^']+'\ with\ message\ ')/ php_stack_begin
php_stack_begin /^Stack trace:/ php_stack_frames
php_stack_frames /^#\d/ php_stack_frames
php_stack_frames /^\s+thrown in / start_state
# Go
start_state /\bpanic: / go_after_panic
start_state /http: panic serving/ go_goroutine
go_after_panic,go_after_signal,go_frame_1 /^$/ go_goroutine
go_after_panic /^\[signal / go_after_signal
go_goroutine /^goroutine \d+ \[[^\]]+\]:$/ go_frame_1
go_frame_1 /^(?:[^\s.:]+\.)*[^\s.():]+\(|^created by / go_frame_2
go_frame_2 /^\s/ go_frame_1
# Ruby
start_state /Error \(.*\):$/ ruby_before_rails_trace
ruby_before_rails_trace /^ $/ ruby
ruby_before_rails_trace /^[\t ]+.*?\.rb:\d+:in `/ ruby
ruby /^[\t ]+.*?\.rb:\d+:in `/ ruby
# Dart
start_state /^Unhandled exception:$/ dart_exc
dart_exc /^(Instance of)|(Exception)|(Bad state)|(IntegerDivisionByZeroException)|(Invalid argument)|(RangeError)|(Assertion failed)|(Cannot instantiate)|(Reading static variable)|(UnimplementedError)|(Unsupported operation)|(Concurrent modification)|(Out of Memory)|(Stack Overflow)/ dart_stack
dart_exc /^'.+?':.+?$/ dart_type_err_1
dart_type_err_1 /^#\d+\s+.+?\(.+?\)$/ dart_stack
dart_type_err_1 /^.+?$/ dart_type_err_2
dart_type_err_2 /^.*?\^.*?$/ dart_type_err_3
dart_type_err_3 /^$/ dart_type_err_4
dart_type_err_4 /^$/ dart_stack
dart_exc /^FormatException/ dart_format_err_1
dart_format_err_1 /^#\d+\s+.+?\(.+?\)$/ dart_stack
dart_format_err_1 /^./ dart_format_err_2
dart_format_err_2 /^.*?\^/ dart_format_err_3
dart_format_err_3 /^$/ dart_stack
dart_exc /^NoSuchMethodError:/ dart_method_err_1
dart_method_err_1 /^Receiver:/ dart_method_err_2
dart_method_err_2 /^Tried calling:/ dart_method_err_3
dart_method_err_3 /^Found:/ dart_stack
dart_method_err_3 /^#\d+\s+.+?\(.+?\)$/ dart_stack
dart_stack /^#\d+\s+.+?\(.+?\)$/ dart_stack
dart_stack /^<asynchronous suspension>$/ dart_stack
+2 -2
View File
@@ -1,4 +1,4 @@
@version: 3.35
@version: 4.3
@include "scl.conf"
# Syslog-ng configuration file, compatible with default Debian syslogd
@@ -7,7 +7,7 @@
# First, set some global options.
options { chain_hostnames(off); flush_lines(0); use_dns(no); use_fqdn(no);
dns_cache(no); owner("root"); group("adm"); perm(0640);
stats_freq(0); bad_hostname("^gconfd$");
stats(freq(0)); bad_hostname("^gconfd$");
};
########################
+1
View File
@@ -9,6 +9,7 @@ SYSLOG_NG_BUILD_PATH=/bd_build/services/syslog-ng
$minimal_apt_get_install syslog-ng-core
cp $SYSLOG_NG_BUILD_PATH/syslog-ng.init /etc/my_init.d/10_syslog-ng.init
cp $SYSLOG_NG_BUILD_PATH/syslog-ng.shutdown /etc/my_init.post_shutdown.d/10_syslog-ng.shutdown
cp $SYSLOG_NG_BUILD_PATH/smart-multi-line.fsm /usr/share/syslog-ng/smart-multi-line.fsm
mkdir -p /var/lib/syslog-ng
cp $SYSLOG_NG_BUILD_PATH/syslog_ng_default /etc/default/syslog-ng
touch /var/log/syslog
+9 -3
View File
@@ -22,10 +22,16 @@ ln -s /etc/container_environment.sh /etc/profile.d/
$minimal_apt_get_install runit
## Install a syslog daemon and logrotate.
[ "$DISABLE_SYSLOG" -eq 0 ] && /bd_build/services/syslog-ng/syslog-ng.sh || true
if [ "$DISABLE_SYSLOG" -eq 0 ]; then
/bd_build/services/syslog-ng/syslog-ng.sh
fi
## Install the SSH server.
[ "$DISABLE_SSH" -eq 0 ] && /bd_build/services/sshd/sshd.sh || true
if [ "$DISABLE_SSH" -eq 0 ]; then
/bd_build/services/sshd/sshd.sh
fi
## Install cron daemon.
[ "$DISABLE_CRON" -eq 0 ] && /bd_build/services/cron/cron.sh || true
if [ "$DISABLE_CRON" -eq 0 ]; then
/bd_build/services/cron/cron.sh
fi