DOC-01: インフラストラクチャの準備 (Proxmox & Ubuntu)
Proxmox VEでのリソースのプロビジョニングの初期ステップ、Ubuntu Serverの設定、安定したDockerエンジンのデプロイ。
この技術ドキュメントは、Proxmox VEハイパーバイザー上の仮想化環境でベースオペレーティングシステム(Ubuntu Server)をプロビジョニングおよびパラメータ設定するための運用指針を確立し、Redmineコンテナスタックのデプロイに備えます。
2. 仮想マシンの要件(Proxmox VE)
Sección titulada «2. Requisitos de la Máquina Virtual (Proxmox VE)»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»# Actualizar base de datos de paquetes y parches del kernelsudo apt update && sudo apt upgrade -y3.2. オペレーションユーティリティのインストール
Sección titulada «3.2. Instalación de Utilidades de Operación»コンソールでのデバッグおよび構成編集に必要な基本ツールをインストールします:
sudo apt install -y curl wget git nano unzip htop4. Docker Engineのインストール(オフィシャル安定チャネル)
Sección titulada «4. Instalación de Docker Engine (Canal Oficial Stable)»[!IMPORTANT]\n
snap経由でパッケージされたDockerバージョンやUbuntuのデフォルトソースは、更新されたCompose V2プラグインとの直接互換性がないため、使用を禁じます。公式のフローに従ってください:
# 1. Instalar dependencias previas de enrutamiento segurosudo 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 Dockercurl -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 Aptecho "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 modernosudo apt updatesudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin5. オペレーション権限の管理(インストール後)
Sección titulada «5. Gestión de Privilegios Operativos (Post-Instalación)»Dockerソケットとの対話時にsudoコマンドを継続的に使用するのを避けるため(運用リスクの軽減と自動化の簡略化)、システムユーザーをDockerエンジンのグループに追加します:
sudo usermod -aG docker $USER[!CAUTION]\n必須の運用手順: 現在のユーザートークンの権限を再読み込みするには、アクティブなターミナルセッション(
exit)からログアウトし、SSHサーバーに再度ログインする必要があります。
6. オペレーションの検証
Sección titulada «6. Verificación de Funcionamiento»サービスがアクティブでユーザーがローカルデーモンに対して完全な権限を持っていることを確認してください:
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の確認。 - ✓ アクセスセキュリティ: コンテナエンジンを操作するためにコンソールセッションを再読み込みしました。

