AI/AI Eco System

맥북에서 Portainer를 사용하여 VM 내의 Docker 컨테이너 관리

조병희 2025. 3. 11. 10:09

실리콘 CPU가 나오면서 도커로 실행시 오류가 나는 경우가 많다. 일부는 도커 실행 옵션을 줘서 해보기도 하지만 그래도 여의치않아 UTM으로 우분투 서버를 VM으로 설치했다. 아무래도 GUI로 관리하는 것이 유용한데 호스트와 VM둘다 설치하지 않고 호스트의 Portainer로 통합 관리하고자 한다.

(아래는 chatgpt로 작성된 자료로 아직 실제로 해보지 않은 내용입니다.)

맥북에서 Portainer를 사용하여 VM 내의 Docker 컨테이너를 관리하려면 다음 단계를 따르세요:

  1. VM 내 Docker 설치 및 설정:
    • 먼저, Ubuntu Server VM에 Docker가 설치되어 있어야 합니다. 설치되지 않았다면 다음 명령어를 사용하여 설치할 수 있습니다:
      sudo apt-get update
      sudo apt-get install -y docker.io
      sudo systemctl start docker
      sudo systemctl enable docker
  2. Docker API 원격 접근 설정:
    • Docker 데몬이 원격 API 요청을 수락하도록 설정해야 합니다. /etc/docker/daemon.json 파일을 편집하여 다음 내용을 추가합니다:
      {
        "hosts": ["tcp://0.0.0.0:2375", "unix:///var/run/docker.sock"]
      }
    • Docker 데몬을 재시작합니다.
      sudo systemctl restart docker
  3. 방화벽 설정:
    • Docker API 포트(기본적으로 2375)가 방화벽에 의해 차단되지 않도록 설정합니다. UFW를 사용하는 경우 다음 명령어를 실행합니다.
      sudo ufw allow 2375/tcp
      sudo ufw reload
  4. 맥북에서 Portainer 설치:
    • 맥북에서 Portainer를 Docker 컨테이너로 실행합니다. 다음 명령어를 사용하여 Portainer를 설치하고 실행합니다.
      docker volume create portainer_data
      docker run -d -p 9000:9000 --name=portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce
  5. Portainer에서 원격 Docker 엔드포인트 추가:
    • 웹 브라우저를 열고 http://localhost:9443으로 이동하여 Portainer UI에 접속합니다.
    • 초기 설정을 완료한 후, "Endpoints" 메뉴로 이동하여 "Add Endpoint"를 클릭합니다.
    • "Endpoint type"을 "Docker"로 선택하고, "Endpoint URL"에 VM의 IP 주소와 포트(예: tcp://<VM_IP>:2375)를 입력합니다.
    • "Name" 필드에 적절한 이름을 입력하고 "Add Endpoint"를 클릭합니다.

이제 Portainer를 통해 맥북에서 VM 내의 Docker 컨테이너를 관리할 수 있습니다.