모두의 지식 저장고

dial unix /run/user/0/bus: connect: permission denied 에러 

• 현상:
  • level=error msg="failed to move the rootless netns pasta process to the systemd user.slice: dial unix /run/user/0/bus: connect: permission denied"
  • rootless 환경에서 Podman을 실행 중인데, DBus 및 systemd 관련 문제가 있어 발생 하는 문제 

• 조치 
  • Linger=yes 설정 확인 

whoami
id
loginctl show-user $(whoami)
loginctl enable-linger $(whoami)

• DBus 및 systemd user session 문제 해결
  • 모든 네트워크 및 DNS 설정 삭제 & Podman 시스템 전체 초기화 

rm -rf ~/.config/containers/aardvark-dns
rm -rf ~/.local/share/containers/networks
 
podman system reset

Error: creating container storage: the container name "ora19c" is already in use

• podman ps -a  | grp [container 이름]:현재 실행 중인  컨테이너 확인
• 실행중인 컨테이너 삭제 
• 삭제 안될시 강제 삭제 

#컨테이너 중지및 삭제 
podman stop ora19c
podman rm ora19c
 
#컨테이너 명으로 삭제 
podman rm -f ora19c
#컨테이너 ID 로 삭제 
podman rm -f 4f831c2930bf

Podman Registry 설정 방법

기본 레지스트리 지정 방법

• 설정 파일 : /etc/containers/registries.conf
• 등록 방법 :unqualified-search-registries

unqualified-search-registries = ["docker.io", "quay.io", "registry.fedoraproject.org"]

• 사용자 지정 프라이빗 레지스트리 등록 방법 : [[registry]]

[[registry]]
location = "myregistry.example.com"
insecure = false

• location : 사용할 레지스트리 주소
• insecure = false : HTTPS(보안 연결) 사용 (기본값)
• insecure = true : HTTP(보안 미사용) 허용 (사내 레지스트리에서 필요할 수 있음)

podman 설정 적용 

• 버전 정보 확인 

podman version
 
podman compose version

• podman 재시작 

 systemctl  restart podman

podman  기본 사용 명령어 

• podman image 삭제 방법 

#실행 중인 것 포함하여 모든 컨테이너 정리 
podman stop -a
#컨테이너 삭제 
podman rm -a
#podman 사용 이미지 삭제 
podman rmi -a
 
#모든 pod 삭제 
podman pod rm -a
 
#캐시 및 네트워크 데이터도 정리 
podman system prune -a

podman error  조치 가이드

• 현상:
  • level=error msg="failed to move the rootless netns pasta process to the systemd user.slice: dial unix /run/user/0/bus: connect: permission denied"
  • rootless 환경에서 Podman을 실행 중인데, DBus 및 systemd 관련 문제가 있어 발생 하는 문제 

• 조치 
  • Linger=yes 설정 확인 

whoami
id
loginctl show-user $(whoami)
loginctl enable-linger $(whoami)

• DBus 및 systemd user session 문제 해결
  • 모든 네트워크 및 DNS 설정 삭제 & Podman 시스템 전체 초기화 

rm -rf ~/.config/containers/aardvark-dns
rm -rf ~/.local/share/containers/networks
 
podman system reset

Podman의 스토리지 경로를 변경

• 현재 podman 스토리지 설정 경로 확인 및 변경 

mkdir /nvme/podman_storage/run
mkdir /nvme/podman_storage/lib
 
vi /etc/containers/storage.conf
 
[storage]
driver = "overlay"
 
# Temporary storage location
#runroot = "/run/containers/storage"
runroot = "/nvme/podman_storage/run"
 
#graphroot = "/var/lib/containers/storage"
graphroot = "/nvme/podman_storage/lib"
 
 
 
 
sudo systemctl stop podman
sudo mv /var/lib/containers/storage /nvme/podman_storage/lib
sudo mv /var/run/containers/storage /nvme/podman_storage/run
sudo systemctl start podman

Docker 명령 수행시 에러 발생 

• 도커를 사용 하면서 발생한 문제에 대해 해결 방법에 대한 기록 입니다. 

! no space left on device 에러

에러 내용

• Docker 빌드 과정에서 파일을 복사하는 도중  발생하는 문제로 시스템 디스크 공간 부족 문제로 발생 할수 있습니다. 
• 에러 발생 디렉 토리로 이동하여 사용현황 확인후 디스크를 정리 합니다. 

해결 방법1

docker system prune -a --volumes

• 사용하지 않는 Docker 이미지, 컨테이너, 네트워크, 볼륨 등을 삭제하여 공간을 확보합니다.
• 아래 그림처럼 docker system prune 명령을 수행한후 디스크 용량이 확보 되었습니다. 
  • 단 중지된 컨테이너, 사용하지 않는 이미지, 네트워크, 볼륨을 삭제 하기때문에 사용하는 생성해둔 모든  Docker image 가 삭제 될수 있습니다. 

해결방법2(추천)

• Docker 디렉터리 위치 변경
• /etc/docker/daemon.json 파일을 수정한후 여유있는 디스크로 Docker 디렉토리를 변경 합니다. 
• vi /etc/docker/daemon.json 

{
     "data-root": "/home/docker-directory"
}

• 이후 Docker 를 재기동 합니다. 

systemctl restart docker

Docker Trouble Shuting Guide 

Docker 사용시 발생한 문제 및 해결책들에 대해 공유 하도록 하겠습니다. 

• 문제 : ERROR: Failed to Setup IP tables 에러 
• 해결책 : systemctl restart docker.service

docker-compose 란? 

여러개의 컨테이너가 유기적으로 묶여서 하느의 어플리케이션으로서 동작이 필요할경우 유용하게 사용할수 있는기능입니다. 

예를 들어 웹 어플리케이션을 서비스 한다고 했을 때  서비스가 실행되기 위해서는 웹서버(Apache, IIS, Nginx )와 Database(Oralce,Tibero,Mysql,posgressSql) 컨테이너를 생성해야 합니다. 

Docker 로 해당 서비스를 수행한다고 하면 아래와 같이 매번 docker run  옵션을 설정해 CLI(Commnad Line Interface) 컨테이너를 생성 해야 합니다. 

docker-compose 는 이런 번거로움을 해결하기 위해 여러 컨테이너를 하나의 서비스로 묶어 다룰수 있도록 작업 환경을 제공합니다. 

1.Docker 를 통한 웹 서비스 컨테이너 생성 방법

2.docker-compose (docker-compose.yml)를 이용한 웹 서비스 컨테이너 생성 

위 그림 처럼 도커 컴포즈는 docker-compose.yml 에 서비스할 컨테이너를 정의 하고 묶음으로 관리 할수 있다.

• docker-compose.yml
  • version :YAML 파일 포맷 버전을 나타냅니다. 
  • service : 생성될 컨테이너들의 묶음을 나타냅니다. 
  • apach, mysql : 생성할 서비스 이름입니다. 

3.docker-compose  와 Docker 호환성 메트릭스 

도커컴포즈는 yml 파일로 컨테이너 구성하는데 사용하는 도커 버전에 따라 도커 컴포즈 버전을 맞춰서 사용해야 한다. 

현재 도커 컴포즈 버전은 3.9 버전까지 릴리즈 되어 있습니다. 

아래표는 도커 컴포즈 와 호환되는 도커 버전에대한 호환성 메트릭스 표입니다. 

https://docs.docker.com/compose/compose-file/compose-file-v3/

docker-compose를 사용해서 Mysql을 설치 진행을 해보겠습니다. 

파일 구조는 아래와 같습니다.

파일구조

$ tree db
db root directory 
|-- docker-compose.yml // mysql 빌드 파일 
`-- env.mysql // 환경 파일 

mysql 환경 파일 (env.mysql)

MYSQL_DATABASE=mysql8
MYSQL_ROOT_PASSWORD=admin
MYSQL_USER=testuser
MYSQL_PASSWORD=userpasswd

mysql compose 파일(docker-compose.yml)

version: '3.8'
 
services:
  mysql_db: ## Service Name
 
    container_name: mysql-8  ## Container Name
 
    image: mysql:8.0
 
    env_file:
      - ./env.mysql
 
    ports:
      - 23306:3306
 
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
 
    volumes:
      - ./mysql_data:/var/lib/mysql

mysql 설치 (docker-compose up -d)

mysql 상태 확인 

• docker image ls 명령을 통해 mysql 이미지가 생성된 것을 확인할 수 있습니다. 

• docker-compose ps 명령을 통해 컨테이너 상태를 확인할 수 있습니다. 

mysql Data file 확인 

도커 설치 후 mysql_data 디렉터리가 생성이 되었고 해당 디렉터리에 데이터 파일이 생성됩니다. 

docker-compose 파일에 volume 설정을 하면  호스트 디렉터리에  mysql_data  디렉터리가 없더라도 빌드 과정에서 

자동으로 생성 되게 됩니다. 

    volumes:
      - ./mysql_data:/var/lib/mysql =>  [host volume]:[container volume]

mysql 컨테이너 접속 및 실습

• docker-compose exec mysql_db /bin/bash 명령을 통해 컨테이너에 접속을 합니다.
• mysql -u testuser  -p --host 127.0.0.1 접속 명령을 통해 mysql에 접속합니다. 
  • MYSQL_USER=testuser
  • MYSQL_PASSWORD=userpasswd
• show database 명령을 통해 접속 db를 확인합니다.
  • MYSQL_DATABASE=mysql8
• t_board 테이블을 생성합니다. 
• show tables  명령을 통해 생성된 테이블을 확인합니다. 
• t_board  테이블에 데이터를 입력합니다. 
• 입력한 데이터를 조회합니다. 

Sample data

CREATE TABLE t_board (
board_idx INT(11) NOT NULL AUTO_INCREMENT COMMENT ' ',
title VARCHAR(300) NOT NULL COMMENT '',
contents TEXT NOT NULL COMMENT '',
hit_cnt SMALLINT(100) NOT NULL DEFAULT '0' COMMENT '',
created_datetime DATETIME NOT NULL COMMENT '',
creator_id VARCHAR(50) NOT NULL COMMENT '',
updated_datetime DATETIME DEFAULT NULL COMMENT '',
updater_id VARCHAR(50) DEFAULT NULL COMMENT '',
deleted_yn CHAR(1) NOT NULL DEFAULT 'N' COMMENT ' ',
PRIMARY KEY (board_idx)
);
 
insert into t_board(board_idx,title, contents, hit_cnt,created_datetime, creator_id,  deleted_yn)
values(1,'제목','내용 작성',1,SYSDATE(),'tester','N');
 
 
select * from t_board;

• 테스트 테스트 진행 

docker-compose 를 이용해 빌드를 진행해 보겠습니다. 

파일 구조는 아래와 같습니다. 

os
|-- Dockerfile : 빌드 하기 위한 도커 파일 
`-- docker-compose.dev.yml : docker-compose 에서 실습할 yml 파일 

ubuntu 20.04 버전으로 이미지를 만들도록 하겠습니다. 

내용은 없습니다. 

Docker File 생성(Dockerfile) 

FROM ubuntu:20.04
RUN echo " TEST ubuntu"

docker-compose.yml 파일 생성 (docker-compose.dev.yml)

version: '3.8'
 
services:
 
     ubuntu: ## Service Name
 
         container_name: ubuntu20  ## Container Name
 
         build:
           context: . ## build Docker file location
           dockerfile: Dockerfile ## build file name

docker-compose build

docker-compose 수행시 사용되는 default 파일명은 docker-compose.yml 입니다. 

운영과 개발 이미지를 분리하고자 한다면 docker-compose.dev.yml (개발) or docker-compose.prod.yml 처럼 

파일을 분리해서 컨테이너를 관리하면 됩니다. 

만약  default 파일이 없다면 아래와 같은 에러가 발생합니다. 

docker-compose build
ERROR: 
        Can't find a suitable configuration file in this directory or any
        parent. Are you in the right directory?
        Supported filenames: docker-compose.yml, docker-compose.yaml, compose.yml, compose.yaml

docker-compose 명령을 통해 Dockerfile 빌드를 진행후 생성된 이미지를 확인 합니다. 

이미지명은 현재 디렉토리명_커테이너명(os_ubuntu )으로 생성됩니다. 

1. docker-compose -f docker-compose.dev.yml build  // 이미지 빌드 
2. docker-image ls // 도커 이미지 확인 

Docker Container 기동 및 확인 

컨테이너 기동 명령어는 docker-compose -f [compose file name ] up or up -d 입니다. -d 일경우 컨테이너가 백그라운드로 실행 되게 됩니다. 

docker-compose -f docker-compose.dev.yml up 또는 

docker-compose -f docker-compose.dev.yml -up -d (백그라운드 실행)

컨테이너 상태 확인 시 종료 되어있습니다. 

Docker 는 Virtual machine 이 아니라 가상화된 공간을 제공해 줄 뿐이다 .

이러한 이유로 docker-compose up 을 수행해도  컨테이너는 기동 후 바로 종료된다. 

Docker Container 접속

• docker-compose.dev.yml

version: '3.8'
 
services:
 
     ubuntu: ## Service Name
 
         container_name: ubuntu20  ## Container Name
 
         build:
           context: . ## build Docker file locate
           dockerfile: Dockerfile ## build file name
 
         command:  tail -f > /dev/null​

재기동 및 접속 

• docker-compose down : 도커 컨테이너를 중지 시키고 삭제 합니다.
• docker-compose stop : 도커 컨테이너를 중지 시킵니다. 
• docker-compose start : 도커 컨테이너를 실행합니다. 
• docker-compose ps : 컨테이너 상태를 확인합니다.
• docker-compose exec [servicename] [shell cmd] : 도커 컨테이너 접속 
  • 접속시 컨테이너 명이 아니고 .yml 파일에 작성한  서비스 명(ubuntu)입니다. 

이전에  Docker 를 활용해 Oracle19c 를 설치 하는 방법에 알아 보았습니다. 

이번에는 docker-compose 를 활용해서 Oracle19c 를 설치 해보겠습니다. 

설치를 위한 파일 구조 생성 

이전에 소개했던 오라클19c 설치 글 (https://growupcoding.tistory.com/18 ) 내용과 거의 동일 하며 

Docker 오라클 실행 부분만 docker-compose를 활용해 설치해보겠습니다. 

compose 디렉토리 생성 및 공유 디렉토리 권한 변경

• compose : 파일 및 Oracle19c 가 설치될 파일 디렉토리를 만듭니다. 
• docker-compose.ora19c.yml : 이미지 빌드를 하기 위한 compose 파일 
• or19env :  오라클 환경파일(ORACLE_HOME, ORACLE_SID)
• oradata/ora19_data :오라클 데이터 파일이 생성될 공유 디렉토리

compose 디렉토리 생성

mkdir -p compose/oradata/ora19_data
 
chmod -Rf 777 compose/oradata/ora19_data

사전 확인 및 준비 사항 (image,환경파일) 

docker-compose.yml 작성 

• env_file : 오라클에서 container 사용하게될 환경 변수 입니다. 
• image : 빌드를 하게될 오라클 19c 이미지입니다. 
• ports : 오라클 컨테이너와 통신에 사용하게될 통신 포트 입니다. 설정은 host port: container port 로 작성 합니다. 
• volumes : 컨테이너와 공유하게될 호스트 볼륨 정보입니다. 

version: '3.8'
 
 services:
     ora19c:
         container_name: ora19c
 
         env_file:
             - ora19env
 
         image: oracle/database:19.3.0-ee
 
         ports:
             - 1521:1521
             - 5500:5500
 
         volumes:
             - ./oradata/ora19_data:/opt/oracle/oradata
 
         privileged: true

Docker 명령어와 비교해 보겠습니다.

빌드시 항항 명령어를 기억해야 하지만 docker-compose 파일로 관리 하면 이미지별 컨테이너 관리도 쉽습니다. 

또 서비스에 여러개의 컨테이너를 등록 할수도 있습니다. 

• 오라클 Docker 명령

docker run  \
--name oracle19c \
-p 1519:1521 \
-p 5519:5500 \
-e ORACLE_PWD=oracle \
-e ORACLE_SID=orclcdb \
-v ./data:/opt/oracle/oradata \
oracle/database:19.3.0-ee

docker-compose 빌드 

Docker 프로세스 확인

• docker-compose -f docker-compose.ora19c.yml ps -a
• docker ps -a 

Docker Container 실행 및 컨테이너 접속

실행결과

Docker-compose 기본 명령 

docker-compose -f [docker compose 파일] [명령어]
docker-compose -f docker-compose.ora19c.yml up
docker-compose -f docker-compose.ora19c.yml up -d // 백그라운드 모드 실행 
 
docker-compose -f docker-compose.ora19c.yml start // 정지한 컨테이너를 시작
docker-compose -f docker-compose.ora19c.yml start ora19c // 컨테이너가 여러개일경우 ora19c 
 
docker-compose -f docker-compose.ora19c.yml restart // 이미 실행 중인 컨테이너 다시 시작
 
 
 
 
 
docker-compose -f docker-compose.ora19c.yml stop // 컨테이너 중지
 
docker-compose -f docker-compose.ora19c.yml down // 컨테이너 중지및 삭제
 
docker-compose -f docker-compose.ora19c.yml  logs // 컨테이너로그 확인
 
docker-compose -f docker-compose.ora19c.yml ps // 컨테이너 목록 
 
//Docker 접속 
docker-compose exec [컨테이너] [명령어]
docker-compose -f docker-compose.ora19c.yml exec ora19c /bin/bash​

docker-compose install

sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

docker-compose 권한 부여

sudo chmod +x /usr/local/bin/docker-compose

docker-compose 버전 확인

docker-compose --version

실행 

docker compose V1 , V2

• docker-compose 는 2023 년 7월 이후 더이상 업데이트 되지 않습니다. 

• 지금까지 사용했던 compose 버전은 V1 이 였습니다. 
• 앞으로 더이상 지원 하지 않는 버전이라고 하니 V1 삭제후 V2 로 재설치 하는 방법에 대해 알아봅니다. 
• 다시말하면 docker-compose 은 v1 이고  docker compose(하이픈 - 없는것) 은 V2 버전으로 알고 있으면 되겠네요.

https://docs.docker.com/compose/migrate/#what-are-the-differences-between-compose-v1-and-compose-v2

docker compose  V2 Install 

• 설치된 v1 을 삭제 하고 v2 를 설치 합니다. 

docker-compose  v1 uninstall 

sudo yum remove docker-compose-plugin

docker-compose  v2 install 

sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

설치 버전 확인 

Ubuntu Repository update

sudo apt-get update
 
sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release
    
    
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg    
 
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

Docker Engine 설치

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io

Docker Version 선택 설치 

도커는 버전별로 선택해서 설치를 진행 할수 있습니다. 

설치 가능 버전 확인후 선택해서 설치를 진행하면 됩니다. 

설치 버전 확인 

Docker 버전 선택 설치 

#sudo apt-get install docker-ce=<VERSION_STRING> docker-ce-cli=<VERSION_STRING> containerd.io
sudo apt-get install docker-ce=5:19.03.15~3-0~ubuntu-focal docker-ce-cli=5:19.03.15~3-0~ubuntu-focal containerd.io

Docker 중지/시작 명령어 

#도커 재시작 
service docker restart
#도커 중지 
service docker stop
 
#도커 시작 
service docker start

Docker 상태 확인

docker ps -a