1. 概要
DGX Spark 上に Sonatype Nexus Repository 3 を Docker で構築し、Maven / npm / Docker のキャッシュ（プロキシ）リポジトリを構築する。
目的
- Maven Central、npm registry、Docker Hub、APT のプロキシ兼キャッシュを構築する
- 社内やローカル環境から高速にパッケージを取得できるようにする
前提と確認済み事項
| 項目 | 値 |
|---|---|
| ホスト | gx10-6acc.local（DGX Spark） |
| OS / アーキテクチャ | Ubuntu / aarch64 (ARM64) |
| Docker | 29.2.1 |
| Docker Compose | v5.0.2 |
| Nexus イメージ | sonatype/nexus3:latest |
| ポート | 18081（Nexus UI / API）、15000（Docker registry） |
| 認証 | 匿名アクセス |
| データ置き場 | 当面はシステムディスク上の /mnt/repo/nexus-data、SSD
調達後に /mnt/repo を SSD にマウントし直して移行 |
※ docker.io
からログアウトしておくこと。そうしないと上手く Nexus
を利用してくれないっぽい
全体の流れ
- 事前準備（SSH 接続、ディレクトリと設定ファイルの作成）
- Nexus のデプロイ
- リポジトリ作成（Maven / npm / Docker / APT）
- クライアント設定
- 動作検証
- （後日）SSD 調達後の
/mnt/repo移行
2. 事前準備
2.1 SSH 接続
ssh gx10-6acc.local2.2 作業ディレクトリの作成
Nexus の設定ファイルを置くディレクトリを作成する。
mkdir -p ~/project/nexus
cd ~/project/nexus2.3 データディレクトリの作成
Nexus のデータを保存するディレクトリを作成する。
sudo mkdir -p /mnt/repo/nexus-data
sudo chown -R 200:200 /mnt/repo/nexus-data200:200は Nexus コンテナ内の実行ユーザー（UID/GID 200）である。- Nexus がデータディレクトリに書き込めるよう、所有権を合わせる。
- SSD 移行について: 現時点では
/mnt/repo/nexus-dataはシステムディスク上に作成する。 - SSD 調達後は、このディレクトリを SSD にマウントし直すことで、データをそのまま移行できる（詳細は「7. SSD 調達後の移行」参照）。
3. Nexus のデプロイ
3.1 compose.yaml の作成
~/project/nexus/compose.yaml を作成する。
services:
nexus:
image: sonatype/nexus3:latest
container_name: nexus
restart: always
ports:
- "0.0.0.0:18081:8081" # Nexus UI / API
- "0.0.0.0:15000:15000" # Docker registry
volumes:
- /mnt/repo/nexus-data:/nexus-data
environment:
- INSTALL4J_ADD_VM_PARAMS=-Xms1g -Xmx2g -XX:MaxDirectMemorySize=1gINSTALL4J_ADD_VM_PARAMSで JVM ヒープを設定する。- DGX Spark は残メモリが約 4GB なので、ヒープ 2GB + ダイレクトメモリ 1GB の合計約 3GB から始める。
/mnt/repo/nexus-dataが Nexus のデータディレクトリである。
3.2 Nexus の起動
cd ~/project/nexus
docker compose up -d起動状態を確認する。
docker compose ps3.3 起動完了の待機
Nexus は初回起動に数分かかる。 ログを確認して、起動完了を待つ。
docker compose logs -fログに Started Sonatype Nexus OSS
が表示されたら起動完了である。
3.4 admin パスワードの取得
初回起動時、admin パスワードは自動生成され、コンテナ内のファイルに保存される。
docker exec nexus cat /nexus-data/admin.passwordこのパスワードを控えておく。
3.5 初期設定（Web UI）
ブラウザで http://gx10-6acc.local:18081
にアクセスし、以下を設定する。
admin/ 上記のパスワードでログイン- 新しい admin パスワードを設定
- ウィザードが表示されるので、それに従って進める
- 匿名アクセスを有効化（「Enable anonymous access」を選択）
※ 匿名アクセス: 認証なしでリポジトリを参照できるようにする。
4. リポジトリの作成
4.1 基本情報の定義
これから Web API でリポジトリを作成するため、以下の情報を定義しておく。
NEXUS_URL="http://gx10-6acc.local:18081"
NEXUS_USER="admin"
NEXUS_PASS='<YOUR_ADMIN_PASSWORD>'
BLOB_STORE="default"<YOUR_ADMIN_PASSWORD>は 3.5 で設定した admin パスワードに置き換える。
4.2 Maven プロキシリポジトリ
Web API で maven2 (proxy)
形式のリポジトリを作成する。
| 項目 | 値 |
|---|---|
| Name | maven-central |
| Remote storage | https://repo1.maven.org/maven2/ |
| Blob store | default |
| その他 | 既定値のまま |
プロキシリポジトリは、リモート（Maven Central）から取得したパッケージをローカルにキャッシュする。
実行コマンド
curl -u ${NEXUS_USER}:${NEXUS_PASS} -X POST \
${NEXUS_URL}/service/rest/v1/repositories/maven/proxy \
-H "Content-Type: application/json" \
-d '{
"name": "maven-central",
"online": true,
"storage": { "blobStoreName": "default", "strictContentTypeValidation": true },
"proxy": { "remoteUrl": "https://repo1.maven.org/maven2/", "contentMaxAge": 1440, "metadataMaxAge": 1440 },
"negativeCache": { "enabled": true, "timeToLive": 1440 },
"httpClient": { "blocked": false, "autoBlock": true },
"maven": { "versionPolicy": "RELEASE", "layoutPolicy": "PERMISSIVE" }
}'4.3 npm プロキシリポジトリ
Web API で npm (proxy) 形式のリポジトリを作成する。
| 項目 | 値 |
|---|---|
| Name | npmjs |
| Remote storage | https://registry.npmjs.org/ |
| Blob store | default |
| その他 | 既定値のまま |
実行コマンド
curl -u ${NEXUS_USER}:${NEXUS_PASS} -X POST \
${NEXUS_URL}/service/rest/v1/repositories/npm/proxy \
-H "Content-Type: application/json" \
-d '{
"name": "npmjs",
"online": true,
"storage": { "blobStoreName": "default", "strictContentTypeValidation": true },
"proxy": { "remoteUrl": "https://registry.npmjs.org/", "contentMaxAge": 1440, "metadataMaxAge": 1440 },
"negativeCache": { "enabled": true, "timeToLive": 1440 },
"httpClient": { "blocked": false, "autoBlock": true }
}'4.4 Docker プロキシリポジトリ
Web API で docker (proxy)
形式のリポジトリを作成する。
| 項目 | 値 |
|---|---|
| Name | docker-hub |
| Remote storage | https://registry-1.docker.io/ |
| HTTP port | 15000 |
| HTTPS port | （空のまま） |
| Blob store | default |
- Docker プロキシは HTTP ポート 15000 で公開する。
- ローカル（HTTP）で使うため、HTTPS ポートは設定しない。
実行コマンド
リポジトリ作成
curl -u ${NEXUS_USER}:${NEXUS_PASS} -X POST \
${NEXUS_URL}/service/rest/v1/repositories/docker/proxy \
-H "Content-Type: application/json" \
-d '{
"name": "docker-hub",
"online": true,
"storage": { "blobStoreName": "default", "strictContentTypeValidation": true },
"proxy": { "remoteUrl": "https://registry-1.docker.io/", "contentMaxAge": 1440, "metadataMaxAge": 1440 },
"negativeCache": { "enabled": true, "timeToLive": 1440 },
"httpClient": { "blocked": false, "autoBlock": true },
"docker": { "v1Enabled": false, "forceBasicAuth": false, "httpPort": 15000 },
"dockerProxy": { "indexType": "HUB", "cacheForeignLayers": false }
}'forceBasicAuth: 匿名アクセスを有効にする場合はfalseに設定する
匿名アクセス用 Realm を追加
curl -sS -u "${NEXUS_USER}:${NEXUS_PASS}" \
"${NEXUS_URL}/service/rest/v1/security/realms/active" \
| jq 'if index("DockerToken") then . else . + ["DockerToken"] end' \
| curl -sS -u "${NEXUS_USER}:${NEXUS_PASS}" \
-X PUT \
-H 'Content-Type: application/json' \
--data-binary @- \
"${NEXUS_URL}/service/rest/v1/security/realms/active"匿名ユーザーアクセスの有効化
匿名アクセスは 3.5 の初期設定ウィザードで既に有効化済みである。
ここでの API 呼び出しは、その設定を確認・確実にするためのもので、既に有効なら何も変わらない（冪等）。
curl -sS -u "${NEXUS_USER}:${NEXUS_PASS}" \
-X PUT \
-H 'Content-Type: application/json' \
"${NEXUS_URL}/service/rest/v1/security/anonymous" \
-d '{
"enabled": true,
"userId": "anonymous",
"realmName": "NexusAuthorizingRealm"
}'4.5 APT プロキシリポジトリ
Ubuntu archive
curl -u ${NEXUS_USER}:${NEXUS_PASS} \
-X POST \
"${NEXUS_URL}/service/rest/v1/repositories/apt/proxy" \
-H 'Content-Type: application/json' \
-d '{
"name": "ubuntu-archive",
"online": true,
"storage": {
"blobStoreName": "'"${BLOB_STORE}"'",
"strictContentTypeValidation": true
},
"proxy": {
"remoteUrl": "http://archive.ubuntu.com/ubuntu/",
"contentMaxAge": 1440,
"metadataMaxAge": 60
},
"negativeCache": {
"enabled": true,
"timeToLive": 1440
},
"httpClient": {
"blocked": false,
"autoBlock": true
},
"apt": {
"distribution": "",
"flat": false,
"enforceDistribution": false
}
}'Ubuntu security
curl -u ${NEXUS_USER}:${NEXUS_PASS} \
-X POST \
"${NEXUS_URL}/service/rest/v1/repositories/apt/proxy" \
-H 'Content-Type: application/json' \
-d '{
"name": "ubuntu-security",
"online": true,
"storage": {
"blobStoreName": "'"${BLOB_STORE}"'",
"strictContentTypeValidation": true
},
"proxy": {
"remoteUrl": "http://security.ubuntu.com/ubuntu/",
"contentMaxAge": 1440,
"metadataMaxAge": 60
},
"negativeCache": {
"enabled": true,
"timeToLive": 1440
},
"httpClient": {
"blocked": false,
"autoBlock": true
},
"apt": {
"distribution": "",
"flat": false,
"enforceDistribution": false
}
}'4.6 作成後の確認
作成したリポジトリが一覧に表示されていることを確認する。
maven-centralnpmjsdocker-hububuntu-archiveubuntu-security
リポジトリ一覧の確認
# 全リポジトリの一覧（名前・形式・タイプ・URL）
curl -u ${NEXUS_USER}:${NEXUS_PASS} \
${NEXUS_URL}/service/rest/v1/repositories特定リポジトリの詳細確認
# Maven
curl -u ${NEXUS_USER}:${NEXUS_PASS} \
${NEXUS_URL}/service/rest/v1/repositories/maven/proxy/maven-central
# npm
curl -u ${NEXUS_USER}:${NEXUS_PASS} \
${NEXUS_URL}/service/rest/v1/repositories/npm/proxy/npmjs
# Docker
curl -u ${NEXUS_USER}:${NEXUS_PASS} \
${NEXUS_URL}/service/rest/v1/repositories/docker/proxy/docker-hub
# APT
curl -u ${NEXUS_USER}:${NEXUS_PASS} \
${NEXUS_URL}/service/rest/v1/repositories/apt/proxy/ubuntu-archive
# APT security
curl -u ${NEXUS_USER}:${NEXUS_PASS} \
${NEXUS_URL}/service/rest/v1/repositories/apt/proxy/ubuntu-securityキャッシュ状況の確認
取得後に、Nexus の blob store にキャッシュが溜まっているかを確認できる。
# 各リポジトリのキャッシュ状況（asset 数など）
curl -u ${NEXUS_USER}:${NEXUS_PASS} \
${NEXUS_URL}/service/rest/v1/repositories/maven/proxy/maven-central5. クライアント設定
作成したリポジトリを各クライアントから参照するための設定である。
5.1 Maven
~/.m2/settings.xml にミラー設定を追加する。
<settings>
<mirrors>
<mirror>
<id>nexus</id>
<mirrorOf>*</mirrorOf>
<url>http://gx10-6acc.local:18081/repository/maven-central/</url>
</mirror>
</mirrors>
</settings>※ mirrorOf を * にすると、すべての Maven
リポジトリを Nexus 経由にする。
5.2 npm
npm のレジストリを Nexus に向ける。
npm config set registry http://gx10-6acc.local:18081/repository/npmjs/確認:
npm config get registry5.3 Docker
Docker は HTTP（非 TLS）のレジストリを使うため、daemon 側で insecure registry を許可する必要がある。
/etc/docker/daemon.json に以下を追加する。
{
"registry-mirrors": ["http://gx10-6acc.local:15000"],
"insecure-registries": ["gx10-6acc.local:15000"]
}registry-mirrorsは Docker Hub へのアクセスを Nexus 経由にするための設定である。insecure-registriesは HTTP（非 TLS）でのアクセスを許可するための設定である。
Docker を再起動する。
sudo systemctl restart docker5.4 APT
既存の sources をバックアップ。
sudo cp \
/etc/apt/sources.list.d/ubuntu.sources \
/etc/apt/sources.list.d/ubuntu.sources.bakNexus 用に sources を更新。
sudo tee /etc/apt/sources.list.d/ubuntu.sources >/dev/null <<'EOF'
Types: deb
URIs: http://gx10-6acc.local:18081/repository/ubuntu-archive/
Suites: noble noble-updates noble-backports
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
Types: deb
URIs: http://gx10-6acc.local:18081/repository/ubuntu-security/
Suites: noble-security
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
EOF6. 動作検証
各リポジトリが正しくキャッシュできるか確認する。
6.1 Maven
mvn dependency:get -Dartifact=junit:junit:4.13.2Nexus の Web UI で maven-central リポジトリに
junit がキャッシュされていることを確認する。
6.2 npm
npm view lodash versionNexus の Web UI で npmjs リポジトリに
lodash がキャッシュされていることを確認する。
6.3 Docker
5.3 で設定した registry-mirrors により、Docker Hub への
pull は Nexus 経由になる。そのため、通常の
docker pull alpine で検証できる。
docker pull alpineNexus の Web UI で docker-hub リポジトリに
alpine がキャッシュされていることを確認する。
※ registry-mirrors
経由では、docker pull alpine は自動的に Docker Hub の
library/alpine として解決される。library/
プレフィックスを明示する必要はない。
6.4 APT
apt update で Nexus
経由でのパッケージリスト取得を確認する。
sudo apt updateこれで一通りのキャシュ検証完了。以上。
