Oracle Linux 9 dev container with Node.js 24, Java, .NET 10, Python, docs tools, Japanese support
5.9K
Oracle Linux ベースのポータブルな開発用コンテナシステムです。Podman を使用して、開発ツールや日本語環境が事前設定された開発環境を簡単に構築・利用できます。
Oracle Linux 8、9、10 のマルチバージョンに対応しています。
このコンテナは、次のシナリオで利用できます。
サーバー上にコンテナを常駐させ、VS Code Remote SSH で接続するスタイルです。
コンテナ起動後は SSH サーバーが待機状態となり、ローカルの VS Code から Remote - SSH 拡張機能 を通じて直接接続できます。 ホームディレクトリとワークスペースはホストにマウントされるため、コンテナを再起動しても作業データは保持されます。
[ローカル PC の VS Code]
| SSH 接続 (port 40822 / 40922 / 41022)
v
[リモートサーバー上の Podman コンテナ]
+-- SSH サーバー (常駐)
+-- 開発ツール群
\-- /workspace <- ホストにマウント
この設計により、ローカルに開発ツールをインストールせず、複数人が同一サーバーのコンテナを個別インスタンスとして利用する構成も可能です。
プロジェクトに .devcontainer/ を配置し、Dev Containers 拡張機能から起動するスタイルです。
ローカル環境に Docker または Podman があれば、イメージをダウンロードするだけで即座に開発環境が構築できます。
# サンプル設定をプロジェクトにコピー
cp -r examples/devcontainer/ol8 /your/project/.devcontainer
VS Code で Dev Containers: Reopen in Container を実行すると、開発ツールが事前設定された環境が起動します。
詳細は examples/devcontainer/ および docs/using-in-vscode/ を参照してください。
GitHub Releases から取得した WSL 用 rootfs (tar.gz) を、Windows 標準の PowerShell のみで WSL2 にインポートできます。
詳細は「Windows 環境で WSL2 にインポート」を参照してください。
GitHub Actions 等のビルド・テスト環境としても利用できます。 詳細は docs/using-in-cicd/ を参照してください。
| イメージ | タグ |
|---|---|
| oracle-linux-8-dev | latest / main / vYYYYMMDD.x.x |
| oracle-linux-9-dev | latest / main / vYYYYMMDD.x.x |
| oracle-linux-10-dev | latest / main / vYYYYMMDD.x.x |
podman pull ghcr.io/hondarer/oracle-linux-container/oracle-linux-8-dev:latest
podman pull ghcr.io/hondarer/oracle-linux-container/oracle-linux-9-dev:latest
podman pull ghcr.io/hondarer/oracle-linux-container/oracle-linux-10-dev:latest
GitHub Secrets (DOCKERHUB_USERNAME / DOCKERHUB_TOKEN) を設定した場合、ghcr.io と同一タグで push されます。
| イメージ | タグ |
|---|---|
| hondarer/oracle-linux-8-dev | latest / main / vYYYYMMDD.x.x |
| hondarer/oracle-linux-9-dev | latest / main / vYYYYMMDD.x.x |
| hondarer/oracle-linux-10-dev | latest / main / vYYYYMMDD.x.x |
podman pull hondarer/oracle-linux-8-dev:latest
podman pull hondarer/oracle-linux-9-dev:latest
podman pull hondarer/oracle-linux-10-dev:latest
| ツール | OL8 | OL9 | OL10 |
|---|---|---|---|
| Node.js | 24 | 24 | 24 |
| Java (OpenJDK) | 21 | 21 | 21 |
| .NET SDK | 10 | 10 | 10 |
| Python | 3.12 | 3.12 | 3.12 |
| Go | 1.27.4 | 1.27.4 | 1.27.4 |
| C/C++ (GCC) | 8 | 11 | 14 |
OL9 は /usr/local/bin の python、python3、pip、pip3 で開発用の Python 3.12 を優先します。OS 用の /usr/bin/python3 は 3.9 を維持します。
Go は公式バイナリを /usr/local/go に導入し、3 OS でバージョンを揃えています。go と gofmt は /usr/local/bin から実行でき、go install の導入先 ~/go/bin はログインシェルの PATH に含まれます。/usr/local/go/go.env で GOTOOLCHAIN=local を既定にしているため、go.mod がより新しい Go を要求しても別のツールチェーンは自動ダウンロードされず、エラーになります。自動取得が必要な場合は、GOTOOLCHAIN=auto を環境変数か go env -w で指定してください。イメージサイズを抑えるため、Go 自身のテスト (*_test.go、testdata、test/) は除去しています。利用者のコードの go test や -race には影響しませんが、go test std は実行できません。
eMudhra 証明書問題への対応として、OS の CA パッケージ、pip と新規 venv 用 wheel、certifi を更新し、Node.js は OS の証明書ストアを使用します。コンポーネント別の対策版・導入可否と、Chrome / .NET SDK 同梱ストアの対策は 対応状況 を参照してください。
mmdc, v11.17.0)markitdown[all]、全オプション依存を含めてグローバル導入、バージョン固定なし)rg、Oracle EPEL)clang.cindex と同梱の libclang 共有ライブラリを既定の Python へ導入)意図しないホスト名の書き換えを防ぐため、hostname コマンドは含めていません。ホスト名の確認には uname -n を使用してください。
Git は公式ソースから /usr/local に導入しています。Bash 補完と man ページも 2.56.0 に揃え、通常のログインと sudo git の両方でこのバージョンを使用します。システム設定ファイルは /etc/gitconfig、ユーザー設定は従来どおり ~/.gitconfig です。PCRE2 対応 (git grep -P) と gettext によるメッセージの国際化を有効にしています。公式配布には日本語メッセージの翻訳が含まれないため、既定の日本語ロケールでは Git のメッセージは英語になります。
# OL8 をビルド (既定値)
./build-pod.sh 8
# OL9 をビルド
./build-pod.sh 9
# OL10 をビルド
./build-pod.sh 10
# OL8 インスタンス1 を起動 (既定値)
./start-pod.sh 8
# OL9 インスタンス1 を起動
./start-pod.sh 9
# OL10 インスタンス1 を起動
./start-pod.sh 10
# OL8 SSH 接続 (ポート 40822)
ssh -p 40822 [email protected]
# OL9 SSH 接続 (ポート 40922)
ssh -p 40922 [email protected]
# OL10 SSH 接続 (ポート 41022)
ssh -p 41022 [email protected]
# 初回接続時、SSH 鍵キャッシュの破棄
ssh-keygen -R "[127.0.0.1]:40822"
# OL8 を停止
./stop-pod.sh 8
# OL9 を停止
./stop-pod.sh 9
# OL10 を停止
./stop-pod.sh 10
ホストに ~/.ssh/id_rsa.pub が存在する場合、自動的に SSH キー認証が設定されます。
# SSH キーペア生成 (必要に応じて)
ssh-keygen -t rsa -b 4096
# コンテナ内で各ツールのバージョン確認
node --version
java --version
dotnet --version
python --version
go version
gcc --version
# PlantUML 図の生成
plantuml diagram.puml
# Doxygen ドキュメント生成
doxygen Doxyfile
# Pandoc による文書変換
pandoc README.md -o README.pdf
# Marp による PDF 変換 (システムの Chrome for Testing を自動使用)
marp slides.md -o slides.pdf
# Mermaid 図の SVG 変換
mmdc -i diagram.mmd -o diagram.svg \
--puppeteerConfigFile /etc/mermaid/puppeteer-config.json
Chrome for Testing は /opt/chrome-for-testing/153.0.8010.36/ に配置され、chrome コマンドで利用できます。
chrome --version
PUPPETEER_EXECUTABLE_PATH=/usr/local/bin/chrome と PUPPETEER_SKIP_DOWNLOAD=true が設定済みのため、プロジェクトへ Puppeteer をインストールしてもブラウザは追加ダウンロードされません。
Mermaid CLI で既存の Chrome for Testing を使用する場合は、コンテナ用の Puppeteer 設定を指定してください。設定には Chrome の実行パスと --no-sandbox が含まれています。
npm install puppeteer
コンテナや WSL 環境では Chrome sandbox を利用できないため、起動時に --no-sandbox を指定してください。実行ファイルの指定は不要です。
const puppeteer = require('puppeteer')
const browser = await puppeteer.launch({
headless: true,
args: ['--no-sandbox'],
})
Puppeteer が要求する別バージョンのブラウザを利用する場合は、システム設定を解除してからインストールしてください。
unset PUPPETEER_EXECUTABLE_PATH
export PUPPETEER_SKIP_DOWNLOAD=false
npm install puppeteer
Chrome for Testing はブラウザ自動化・テスト専用です。信頼できるコンテンツに対して使用してください。
# OL8 イメージを圧縮ファイルとして保存
./save-pod.sh 8
# OL9 イメージを保存
./save-pod.sh 9
# OL10 イメージを保存
./save-pod.sh 10
# 保存したイメージを読み込み
./load-pod.sh 8
./load-pod.sh 9
./load-pod.sh 10
src/packages/ にパッケージファイルを配置すると、キャッシュとして動作します。
対象パッケージファイルは、src/Dockerfile を参照してください。
src/fonts/ にフォントファイルを配置すると、システムフォントとして利用可能になります。
ビルド時に英語・日本語・言語共通のリソースを保持して、検証済みの他言語リソースを整理します。Node.js のソースマップ、対応するソースがある Python バイトコード、Git のデバッグ情報も削減します。各インストールと同じビルド層で処理し、Git のハードリンクを保持します。Python バイトコードは利用時に再生成されます。
保持条件とローカル実測は サイズ削減調査 と 言語リソース調査 を参照してください。
./storage/{version}/{instance}/# コンテナの状態確認
podman ps
# コンテナログの確認 (OL8 の場合)
podman logs oracle-linux-8_1
# SSH 鍵キャッシュの破棄 (OL8 の場合)
ssh-keygen -R "[127.0.0.1]:40822"
# SELinux コンテキストの修正
sudo restorecon -R ./storage/
# ストレージディレクトリの再作成 (OL8 インスタンス1 の場合)
rm -rf ./storage/8/1/
mkdir -p ./storage/8/1/{home_$(whoami),workspace}
# 古いイメージの削除 (OL8 の場合)
podman rmi oracle-linux-8
# キャッシュ破棄後の再ビルド
podman system prune -f
./build-pod.sh 8
標準手順では、GitHub Releases に添付された WSL2 用 rootfs (tar.gz) を取得し、Windows 標準の PowerShell のみで WSL2 ディストリビューションとしてインポートします。
# WSL2 のインストール (未インストールの場合)
# --no-distribution を指定しない場合は既定の Ubuntu がインストールされます
wsl --install --no-distribution
# 1. GitHub Releases から OL8 用 rootfs をダウンロード
# https://github.com/hondarer/oracle-linux-container/releases/latest
# 例: oracle-linux-8-dev-vYYYYMMDD.x.x-wsl-rootfs.tar.gz を Downloads に保存
# 2. import-wsl.ps1 をダウンロード
Invoke-WebRequest `
-Uri "https://raw.githubusercontent.com/hondarer/oracle-linux-container/main/examples/import-wsl/import-wsl.ps1" `
-OutFile ".\import-wsl.ps1"
# 3. OL8 をインポート
$RootFs8 = "$env:USERPROFILE\Downloads\oracle-linux-8-dev-vYYYYMMDD.x.x-wsl-rootfs.tar.gz"
powershell -ExecutionPolicy Bypass -File .\import-wsl.ps1 `
-RootFsPath $RootFs8 `
-WslDistroName "OracleLinux8-Dev"
# OL9 の場合
$RootFs9 = "$env:USERPROFILE\Downloads\oracle-linux-9-dev-vYYYYMMDD.x.x-wsl-rootfs.tar.gz"
powershell -ExecutionPolicy Bypass -File .\import-wsl.ps1 `
-RootFsPath $RootFs9 `
-WslDistroName "OracleLinux9-Dev"
# OL10 の場合
$RootFs10 = "$env:USERPROFILE\Downloads\oracle-linux-10-dev-vYYYYMMDD.x.x-wsl-rootfs.tar.gz"
powershell -ExecutionPolicy Bypass -File .\import-wsl.ps1 `
-RootFsPath $RootFs10 `
-WslDistroName "OracleLinux10-Dev"
# インポートされたディストリビューションを起動
wsl -d OracleLinux8-Dev
詳細は examples/import-wsl/README.md を参照してください。
使用を続けて大きくなった仮想ディスク (ext4.vhdx) は、examples/import-wsl/compact-wsl.ps1 で圧縮できます。
詳細は 仮想ディスクの圧縮 を参照してください。
WSL 用 rootfs には rootless Podman、Docker 互換の docker コマンド、podman-compose が含まれます。
既定ユーザー user は、rootless 実行に必要な UID/GID マッピングと cgroupfs 設定を事前に保持します。
podman run --rm quay.io/podman/hello
docker --version
podman-compose --version
systemctl --user status podman.socket
podman.socket は systemd user socket として有効化済みです。
停止されている場合は systemctl --user enable --now podman.socket で起動できます。
このプロジェクトは、スクリプト・ドキュメントと生成されるコンテナイメージでライセンスが異なります。
コンテナイメージは Oracle Linux (GPL-2.0) をベースとしており、GCC・PlantUML・rsync 等の GPL-3.0 コンポーネントを含む多数のオープンソースソフトウェアから構成されています。 イメージを再配布する場合は、含まれる各コンポーネントのライセンス条項 (特に GPL の copyleft 条件) に従う必要があります。
詳細なコンポーネントリストおよびライセンス情報は、次を参照してください。
すべての内容は GitHub の README を参照してください。
Content type
Image
Digest
sha256:a4a904480…
Size
2.1 GB
Last updated
1 day ago
docker pull hondarer/oracle-linux-9-dev