Ir al contenido

DOC-01: 인프라 준비 (Proxmox & Ubuntu)

Proxmox VE에서 리소스 할당 초기 단계, Ubuntu Server 설정 및 안정적인 Docker 엔진 배포

0조회

이 기술 문서는 Ubuntu Server 운영 체제를 Proxmox VE 하이퍼바이저 기반 가상 환경에서 할당하고 설정하는 운영 지침을 정의하며, Redmine 컨테이너 스택 배포를 위한 노드를 준비합니다.


Proxmox 관리 대시보드에서 가상 머신을 생성할 때, Ruby on Rails(내부 엔진) 및 MySQL 데이터베이스 엔진의 아키텍처로 인한 버퍼링을 방지하기 위해 다음 최소 리소스 제한을 구성해야 합니다:

  • CPU (프로세서): 고성능 2개의 vCPU (Proxmox에서 Type: host 설정을 통해 물리적 프로세서 명령어 직접 번역 기능을 활성화하는 것이 권장됨)
  • RAM (메모리): 최소 4GB (Ruby on Rails는 정적 리소스 컴파일 중 메모리를 많이 소비함)
  • 저장소 (디스크): 30GB SSD(또는 NVMe)로 가늘게 할당 (thin provisioning)
  • 운영 체제 (OS): Ubuntu Server 24.04 LTS 또는 22.04 LTS (정확한 설치).

기본 시스템 설치가 완료되고 SSH를 통해 원격으로 안전하게 접속한 후, 시스템을 업데이트하기 위한 명령어를 실행하세요:

Ventana de terminal
# Actualizar base de datos de paquetes y parches del kernel
sudo apt update && sudo apt upgrade -y

콘솔에서 디버깅 및 설정 편집에 필요한 기본 도구를 설치하세요:

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

[!IMPORTANT] snap을 통해 패키징된 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

Docker 소켓과 상호작용할 때 지속적으로 sudo 명령어를 사용하는 것을 피하기 위해 (운영 리스크 완화 및 자동화 간소화), 시스템 사용자를 엔진 그룹에 추가하세요:

Ventana de terminal
sudo usermod -aG docker $USER

[!CAUTION] 필수 운영 단계: 현재 사용자의 토큰 권한을 다시 로드하려면 활성 터미널 세션(exit)을 반드시 종료하고 SSH 서버에 다시 접속해야 합니다.


서비스가 활성화되었고 사용자가 로컬 데몬에 대한 완전한 권한을 가지고 있는지 확인하세요:

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

  • ✓ 할당된 자원: Proxmox 노드에서 CPU, 메모리, 디스크 검증.
  • ✓ 공식 Docker: 설치 채널 검증 stable 구식 snap 버전과 비교.
  • ✓ 접근 보안: 컨테이너 엔진을 운영하기 위해 콘솔 세션 재로드.