Ir al contenido

DOC-01: インフラストラクチャの準備 (Proxmox & Ubuntu)

Proxmox VEでのリソースのプロビジョニングの初期ステップ、Ubuntu Serverの設定、安定したDockerエンジンのデプロイ。

0閲覧数

この技術ドキュメントは、Proxmox VEハイパーバイザー上の仮想化環境でベースオペレーティングシステム(Ubuntu Server)をプロビジョニングおよびパラメータ設定するための運用指針を確立し、Redmineコンテナスタックのデプロイに備えます。


Proxmox管理パネルで仮想マシンをインスタンス化する際、Ruby on Railsアーキテクチャ(Redmineの内部エンジン)とMySQLデータベースエンジンによって生成されるボトルネックを回避するために、次の最小リソース制限を構成する必要があります:

  • CPU(プロセッサ): 高速な2 vCPU(物理プロセッサの命令を直接変換するために、ProxmoxでType: hostを設定することを推奨します)。
  • RAM(メモリ): 4 GB minimum(Ruby on Railsは静的アセットのコンパイル中に大量のメモリを消費します)。
  • ストレージ(ディスク): 30 GB SSD(またはNVMe)でthin provisioningを有効にします。
  • オペレーティングシステム(OS): Ubuntu Server 24.04 LTSまたは22.04 LTS(クリーンインストール)。

3. オペレーティングシステムの準備

Sección titulada «3. Preparación del Sistema Operativo»

ベースシステムのインストールプロセスが終了し、SSHを介してセキュアなリモートアクセスが確立された後、システムを更新するための記述されたコマンドを実行してください:

3.1. システムの更新とセキュリティパッチ

Sección titulada «3.1. Actualización y Parches de Seguridad»
Ventana de terminal
# Actualizar base de datos de paquetes y parches del kernel
sudo apt update && sudo apt upgrade -y

3.2. オペレーションユーティリティのインストール

Sección titulada «3.2. Instalación de Utilidades de Operación»

コンソールでのデバッグおよび構成編集に必要な基本ツールをインストールします:

Ventana de terminal
sudo apt install -y curl wget git nano unzip htop

4. Docker Engineのインストール(オフィシャル安定チャネル)

Sección titulada «4. Instalación de Docker Engine (Canal Oficial Stable)»

[!IMPORTANT]\nsnap経由でパッケージされたDockerバージョンやUbuntuのデフォルトソースは、更新されたCompose V2プラグインとの直接互換性がないため、使用を禁じます。公式のフローに従ってください:

Ventana de terminal
# 1. Instalar dependencias previas de enrutamiento seguro
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release
# 2. Añadir la llave criptográfica GPG oficial del registro de Docker
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
# 3. Registrar el repositorio oficial estable en las fuentes de Apt
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 4. Instalar el motor de contenedores y el plugin Compose moderno
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

5. オペレーション権限の管理(インストール後)

Sección titulada «5. Gestión de Privilegios Operativos (Post-Instalación)»

Dockerソケットとの対話時にsudoコマンドを継続的に使用するのを避けるため(運用リスクの軽減と自動化の簡略化)、システムユーザーをDockerエンジンのグループに追加します:

Ventana de terminal
sudo usermod -aG docker $USER

[!CAUTION]\n必須の運用手順: 現在のユーザートークンの権限を再読み込みするには、アクティブなターミナルセッション(exit)からログアウトし、SSHサーバーに再度ログインする必要があります。


サービスがアクティブでユーザーがローカルデーモンに対して完全な権限を持っていることを確認してください:

Ventana de terminal
docker info
# Debería imprimir información de diagnóstico del host sin advertencias de denegación de acceso

📊 ホスト準備チェックリスト

Sección titulada «📊 Checklist de Preparación de Host»
  • ✓ 割り当てられたリソース: Proxmoxノード上のCPU、メモリ、ディスクの検証。
  • ✓ 公式Docker: 古いsnap版に対するインストールチャネルstableの確認。
  • ✓ アクセスセキュリティ: コンテナエンジンを操作するためにコンソールセッションを再読み込みしました。