SW

[Git] insufficient permission for adding an object to repository database .git/objects - 에러 해결 방법

limsw — Wed, 19 Mar 2025 15:31:22 +0900

서론

이번 글에서는 Git 커밋 시 발생하는 아래 에러에 대한 해결 방법을 알아본다.

error: insufficient permission for adding an object to repository database .git/objects

본론

해당 에러는 Git 저장소의 파일 시스템 권한 부족 문제로 발생한 에러이다.

주로 리눅스 환경에서 사용자 계정의 권한이 부족하거나, .git/objects 디렉토리에 대한 접근 권한이 제한되어 있을 때 발생한다.

해결 방안

1. 문제 확인: .git/objects 디렉토리 권한 확인

$ cd /path/to/your/git/repository/.git/objects
$ ls -al

2. 출력 결과 확인

소유자 및 그룹이 root로 설정되어 있거나, 일반 사용자의 쓰기 권한이 없는 디렉토리가 있는지 확인

예시: drwxr-xr-x 2 root root 4096 Mar 13 13:48 da/

3. 권한 변경 : 사용자에게 소유권 및 쓰기 권한 부여

$ sudo chown -R 사용자명:사용자명 .

사용자명은 현재 사용자의 계정 이름으로 변경한다. (예 chown -R gildong:gildong .)

위 명령은 .git/objects 하위 모든 디렉토리에 대해서 소유자 및 그룹 권한을 변경하는 것이며, 특정 디렉토리의 권한을 변경하고자 하는 경우 아래와 같이 입력한다.

$ sudo chmod -R gildong:gildong da # da는 특정 디렉토리 이름

[Linux] 리눅스(CentOS/RHEL) 안전 모드 실행 방법 - Rescue Mode

limsw — Wed, 18 Dec 2024 16:18:41 +0900

서론

이번 글에서는 레드햇 부팅 시 안전모드(Rescue Mode)로 부팅하는 방법에 대해서 설명한다.

CentOS 환경에서도 동일하게 사용이 가능하나, 이번 포스팅은 레드햇 운영체제를 기준으로 한다.

Rescue Mode

Rescue Mode는 리눅스 시스템이 제대로 부팅되지 않거나, 주요 서비스가 실패했을 때 문제를 진단하고 해결하기 위한 제한된 환경을 제공한다. 시스템이 최소한의 리소스와 서비스를 사용하는 상태로 부팅되며, 일반적으로 루트 파일 시스템만 마운트 된다.

Rescue Mode 사용 필요성

때때로 우리는 리눅스 시스템을 사용하다가 디스크 용량 부족을 경험하기도 하고, 파일 시스템을 잘못 건드려서 파일 시스템 자체가 손상되는 경우가 있다.

이러한 현상들은 시스템 부팅의 실패를 초래할 수 있으며, 이는 리눅스 시스템을 정상적으로 사용하기 어렵게 만든다.

가령, 가상 환경에서 CentOS, RHEL 운영체제를 운영하는 경우에는 동적으로 디스크 용량을 늘릴 수 있지만, 특정 하드웨어 장비에 서버가 탑재되어 운영되는 경우에는 CD, USB 등이 있지 않으면 동적으로 디스크 용량을 늘리거나 확보하기가 어려우며, 특히 폐쇄망 환경에서는 더욱이 디스크 용량을 늘리기가 어렵다.

우리는 이러한 환경에서 흔히 안전 모드(?) 라고 불리는 Rescue Mode를 활용할 수 있다.

Rescue Mode 사용이 필요한 시점을 추가적으로 정리해보면 아래와 같다.

손상된 파일 시스템 복구: 루트 파일 시스템이나 기타 마운트된 파일 시스템이 손상
부트 로더 문제: 부트 로더가 손상되어 시스템 부팅이 실패할 때
루트 암호 복구: 루트 비밀번호를 분실했을 때
커널 문제: 커널 모듈 충돌이나 업그레이드 후 시스템이 부팅되지 않을 때
중요 시스템 파일 수정: 중요한 설정 파일이 잘못되어 정상적인 부팅이 불가능할 때
하드웨어 문제: 디스크 드라이브, RAID, 또는 기타 하드웨어가 실패했을 때

Rescue Mode 활성화 방법

먼저, 최초 시스템을 부팅하면 아래와 같이 이미지를 선택하는 화면이 나오는데 해당 화면에서 알파벳 e 버튼을 누른다.

일정 시간이 지나면 자동적으로 이미지 선택 후 부팅 화면으로 넘어가기 때문에, 타이밍을 잘 맞추어야 한다.

알파벳 e 버튼을 누르면 아래와 같은 화면이 나온다. 우리는 여기서 linux ($root) ..{이하생략}.. 부분의 맨 끝에 명령어를 추가할 예정이다.

systemd.unit=rescue.target 명령어를 추가한다. 그 다음으로는, Ctrl + X를 함께 누른다.

Ctrl + X를 누르면 아래 사진과 같이 루트 패스워드를 입력하는 화면이 나온다. 루트 패스워드를 입력해준다.

루트 패스워드를 입력하고 나면 아래와 같이 CLI 환경이 활성화된다.

아래 그림은 systemctl list-units --type=target 명령어를 입력하여 rescue.target이 활성화 되어 있는지 확인하는 그림이다.

상태가 active로 출력되면 정상적으로 Rescue Mode 접근에 성공한 것이다.

[Linux] 레드햇(RedHat) Local Repository 설정하기

limsw — Tue, 23 Jul 2024 17:44:23 +0900

서론

이번 글에서는 레드햇 운영체제에서 Local Repository를 설정하는 방법을 알아본다.

테스트 환경

테스트 환경은 가상머신(Virtual Box)에서 진행했으며, 레드햇 버전은 8.4 버전을 사용하였다.

rhel-8.4-x86_64-dvd.iso 파일을 레드햇 공식 홈페이지에서 다운로드 받아 진행

방법

먼저 다운로드 받은 rhel-8.4-x86_64-dvd.iso 파일을 서버에 업로드한다.

파일은 /root 경로에 업로드
이후 아래 명령어를 수행할 때에도 root 권한을 얻은 뒤 수행

다음으로는, 아래 명령어를 차례대로 입력해준다.

$ mount -t iso9660 -o loop /root/rhel-8.5-x86_64-dvd.iso /media
$ mkdir /repository
$ cp -a /media/* /repository/
$ vi /etc/yum.repos.d/RHEL8.repo

RHEL8.repo 파일 안에는 아래 내용으로 채워준다.

[InstallMedia-BaseOS]
name=RHEL 8 - BaseOS
metadata_expire=-1
gpgcheck=1
enabled=1
baseurl=file:///repository/BaseOS
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release

[InstallMedia-AppStream]
name=RHEL 8 - AppStream
metadata_expire=-1
gpgcheck=1
enabled=1
baseurl=file:///repository/AppStream
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-redhat-release

wq! 입력으로 저장한 뒤 파일을 빠져나오고, 차례대로 아래 명령어를 입력한다.

$ dnf clean all
$ subscription-manager clean
$ yum grouplist

끝.

크롬 에러 해결 - ERR_SSL_KEY_USAGE_INCOMPATIBLE

limsw — Fri, 12 Apr 2024 09:54:58 +0900

Trouble Shooting : ERR_SSL_KEY_USAGE_INCOMPATIBLE

이전 포스팅에서 OpenSSL을 통해 HTTPS 리액트 환경을 구축하는 방법을 알아보았다.

[React] OpenSSL을 이용한 HTTPS 환경 구축하기

[React] OpenSSL을 이용한 HTTPS 환경 구축하기

서론 이번 글에서는 오픈소스 OpenSSL 패키지를 이용하여 자체 인증서를 생성하고 해당 인증서를 리액트에 적용하여 HTTPS 환경으로 클라이언트를 실행하는 방법을 알아보고자 한다. OpenSSL 이란? Op

limsw.tistory.com

하지만 위 절차대로 하면, 로컬호스트 서버에서는 HTTPS 경로로 잘 접속이 되지만,

노트북, 데스크탑PC 등 원격에서 브라우저로 접속을 시도하면 다음과 같은 에러가 발생했다.

해결방법

OpenSSL 인증서를 생성할 때 keyUsage 부분을 다음과 같이 수정하여 에러를 해결했다.

# build.sh

# keyUsage = keyCertSign, cRLSign
keyUsage = nonRepudiation, digitalSignature, keyEncipherment

[React] OpenSSL을 이용한 HTTPS 환경 구축하기

limsw — Fri, 12 Apr 2024 09:44:20 +0900

서론

이번 글에서는 오픈소스 OpenSSL 패키지를 이용하여 자체 인증서를 생성하고 해당 인증서를 리액트에 적용하여 HTTPS 환경으로 클라이언트를 실행하는 방법을 알아보고자 한다.

OpenSSL 이란?

OpenSSL은 오픈 소스로 개발된 암호 및 보안 라이브러리이다. OpenSSL은 다양한 암호화 알고리즘과 프로토콜을 구현하여 네트워크 통신 간 데이터를 보호하는데 사용된다.

다음 내용은 OpenSSL 에서 제공하는 기능 목록이다.

암호화 및 복호화: OpenSSL은 대표적인 대칭 및 비대칭 암호화 알고리즘을 제공하여, 데이터를 암(복)호화할수 있다. 대표적으로는 AES, RSA, DES, Triple DES 등의 알고리즘을 제공한다.
디지털 서명: OpenSSL은 디지털 서명을 생성하고 검증하는 기능을 제공하여, 메시지의 무결성을 보호한다.
SSL/TLS 프로토콜 구현: OpenSSL은 SSL (Secure Sockets Layer) 및 TLS (Transport Layer Security) 프로토콜을 제공하여 네트워크 통신 보안성을 향상시킨다.
서버 및 클라이언트 인증: OpenSSL은 X509 인증서를 사용하여 서버 및 클라이언트 간 상호 인증을 지원한다.
암호 해싱: OpenSSL은 다양한 해싱 알고리즘을 지원하여 데이터의 무결성을 보장한다.
대표적으로 SHA-1, SHA-256, SHA-512 등의 알고리즘이 있습니다.

본론

먼저, 자체 인증서를 생성하기 위한 스크립트를 만들어보자.

#!/bin/bash

# Create RSA Key
openssl genrsa -aes256 -out rootca.key 2048

chmod 600 rootca.key

# Creating a Configuration File to Use for CSR Files
cat > rootca.conf <<EOL
[ req ]
default_bits            = 2048
default_md              = sha1
default_keyfile         = rootca.key
distinguished_name      = req_distinguished_name
extensions              = v3_ca
req_extensions = v3_ca

[ v3_ca ]
basicConstraints       = critical, CA:TRUE, pathlen:0
subjectKeyIdentifier   = hash
keyUsage               = keyCertSign, cRLSign
nsCertType             = sslCA, emailCA, objCA

[ req_distinguished_name ]
countryName                     = Country Name (2 letter code)
countryName_default             = KR
countryName_min                 = 2
countryName_max                 = 2

organizationName                = Organization Name (eg, company)
organizationName_default        = TEST

organizationalUnitName          = Organization Name (eg, company)
organizationalUnitName_default  = TEST

# SSL domain
commonName                     = Common Name (eg, your name or your server's hostname)
commonName_default             = Self Signed CA
commonName_max                 = 64
EOL

# Create CSR file
openssl req -new -key rootca.key -out rootca.csr -config rootca.conf

# Craete self signed certification
openssl x509 -req -days 365 -extensions v3_ca -set_serial 1 -in rootca.csr -signkey rootca.key -out rootca.crt -extfile rootca.conf

# Create Root CA certification
openssl x509 -text -in rootca.crt

# Delete Configure files
rm -rf rootca.conf

# replace key, crt to pem files
openssl rsa -in rootca.key -text > rootca-key.pem
openssl x509 -inform PEM -in rootca.crt > rootca-crt.pem

위와 같은 내용을 담고있는 build.sh 파일을 생성해준다.

다음으로는 chmod 777 build.sh 명령어를 통해 쉘스크립트 파일을 실행 가능하도록 만든다.

쉘스크립트 파일을 실행하여 rootCA 인증서를 생성한다.

$ ./build.sh

pass phrase 문구가 나오는 부분은 인증서를 생성하기 위해 사용자가 사용할 비밀번호를 입력한다.
Country Name, Organization Name, Common Name은 사용자 소요에 맞게 작성한다. (스크립트 내 Default 설정 되어있음)

인증서 생성이 완료되면 총 5개의 파일이 만들어질 것이다.

rootca.crt / rootca-crt.pem / rootca.csr / rootca.key / rootca-key.pem
rootca-crt.pem 및 rootca-key.pem 파일은 rootca.crt 및 rootca.key 파일을 기반으로 생성된 파일이므로 인증서 내 내용은 동일하다.

리액트에 인증서 적용하기

package.json 파일을 열어 아래 내용을 scripts 부분에 추가한다.

참고로 2개의 pem 파일은 package.json 파일이 존재하는 경로에서 cert 라는 디렉토리를 만들고, 해당 디렉토리 안에 위치시켰다.

"scripts": {
    "start:windows": "HTTPS=true SSL_CRT_FILE=./cert/rootca-crt.pem SSL_KEY_FILE=./cert/rootca-key.pem react-scripts start",
  },

다음 명령어를 통해 리액트 클라이언트를 실행한다.

$  npm run start:windwos

실행 결과

리액트 클라이언트가 정상적으로 실행되면, HTTPS 경로를 통해 접속이 가능하다는 메세지를 확인할 수있다.

[React] vis-network를 이용한 네트워크 토폴로지 그리기

limsw — Fri, 5 Apr 2024 09:52:20 +0900

서론

이번 글에서는 오픈소스 라이브러리인 vis-network 라이브러리를 이용하여 네트워크 토폴로지는 그리는 방법에 대해서 알아본다.

vis-network 라이브러리를 이용하면 각 데이터를 표현하는 노드(Node)와 노드 간 연결정보를 표현하는 엣지(Edge)를 화면상에 시각화 할 수 있으며, 모양/스타일/색상/크기 등을 자유롭게 커스터마이징 할 수 있다.

해당 라이브러리에 대한 자세한 내용은 아래 공식 문서를 참고하길 바란다.

https://visjs.github.io/vis-network/docs/network/

vis.js - Network documentation.

Returns: Array Nodes can be in clusters. Clusters can also be in clusters. This function returns an array of nodeIds showing where the node is. If any nodeId in the chain, especially the first passed in as a parameter, is not present in the current nodes l

visjs.github.io

본론

먼저 라이브러리를 사용하기 위해 패키지를 설치한다.

npm install vis-network --save

패키지 설치가 완료되면 다음과 같이 예제 코드를 작성해보자.

App.js

import React, {useEffect, useRef} from 'react';
import { Network } from "vis-network";

function App() {
  
  const container = useRef(null);
  
  const nodes = [
    {id: 1, label: 'South Korea', size: 20, shape: 'square'},
    {id: 2, label: 'Seoul'},
    {id: 3, label: 'Jeju'},
    {id: 4, label: 'Busan'},
    {id: 5, label: 'Incheon'},
  ]
  const edges = [
    { from: 2, to: 1, label: 'label1'},
    { from: 3, to: 1, label: 'label2'},
    { from: 4, to: 1, label: 'label3'},
    { from: 5, to: 1, label: 'label4'},
  ];
  
  // network topology options.
  const options = {
    nodes: {
      shape: "dot",
      size: 12,
      shadow: true,
      color: {
        border: 'white',
        background: 'skyblue'
      },
      font: {
        color: '#000'
      }
    },
    edges: {
      color: 'gray'
    },
    interaction: {
      hover: true
    }
  };

  // create topology using edges, nodes, options
  useEffect(() => {
    const network = container.current && new Network(container.current, { nodes, edges }, options);

    // Use `network` here to configure events, etc
    network.on("doubleClick", (event) => {
      const { nodes: clickedNodes } = event;
      alert(`id ${clickedNodes} node is clicked.`);
      
    });
  }, [container, nodes, edges]);
  return (
    <div>
      <div ref={container} style={{ height: "500px", width: "100%" }} />
    </div>
  );
}

export default App;

노드의 값으로는 노드ID(id), 노드명(label) 등을 포함한 다양한 옵션이 들어갈 수 있다.
엣지의 값으로는 출발노드(from), 도착노드(to)를 명시하여 연결 관계를 정의할 수 있다.

위 코드를 실행한 결과는 다음과 같다.

기존 options 변수에서 노드의 스타일을 점(dot)으로 정의했지만, nodes 변수에 정의된 스타일이 우선순위가 높아 South Korea 노드의 경우에는 사각형(square)으로 나타나는 것을 확인할 수 있다.

옵션에 interaction: { hover: true } 를 넣어 노드에 hovering 했을 때 해당 노드 및 연결된 엣지가 굵어지는 것을 확인할 수 있다. 이외에도 토폴로지에 사용할 수 있는 옵션은 매우 다양하여 공식 문서를 참고하길 바란다.

또한, network 객체에 doubleClick 이벤트를 추가했으며 노드를 더블클릭 했을 때 나오는 결과는 다음과 같다.

해당 노드의 ID 값을 Alert 메세지로 출력한다.

[Docker] 도커를 이용하여 NTP(Chrony) 서버 구축하기 - Linux

limsw — Tue, 27 Feb 2024 16:13:09 +0900

서론

이번 글에서는 서버에서 직접적인 NTP(Chrony) 서비스의 설치 없이 도커를 이용하여 NTP 서버를 구축하는 방법을 알아본다.

NTP(Network Time Protocol)

NTP는 시간 동기화 프로토콜로 서버 시간을 특정 표준 시간대로 동기화 하는 기능을 지원한다.

리눅스 서버에서는 NTP 또는 Chrony를 주로 사용하고 있으며, 둘 중 아무거나 사용해도 되지만 Chrony가 NTP의 단점을 보완하여 만들어진 서비스이므로 Chrony를 많이 사용하는 추세라고 한다.

해당 글에서는 NTP 개념을 알고 있다는 가정하에 작성하는 글이므로, 디테일한 개념 설명은 넘어간다.

본론

이미지는 도커 허브(Docker hub)에 있는 cturra/ntp 이미지를 이용했다.

https://hub.docker.com/r/cturra/ntp

Docker

hub.docker.com

먼저, 해당 이미지를 가져오고 도커 컨테이너를 실행하는 docker-compose.yml 파일을 작성했다.

version: '3'

services:
  ntp:
    image: cturra/ntp:latest
    container_name: ntp
    restart: always
    ports:
      - 123:123/udp
    environment:
      - NTP_SERVERS="time.cloudflare.com"
      - LOG_LEVEL=0
      - TZ=Asia/Seoul

NTP_SERVERS를 특정 표준시로 설정하면 해당 서비스는 NTP Client의 역할을 한다.
위처럼 구성하면 도커 서비스는 time.cloudfare.com 도메인의 시간대로 동기화를 하는 것이다.
NTP_SERVERS를 127.127.1.0으로 설정하면 해당 서비스는 NTP Server의 역할을 한다.
다시 말하면, 해당 서버는 로컬 시간을 유지하며 타 NTP 클라이언트에게 시간을 공유할 수 있다.

구성한 도커 컴포즈 파일을 실행하기 위해 다음 명령어를 입력한다.

// -d 옵션은 백그라운드 실행 옵션이다.
docker-compose up -d ntp

다음과 같은 출력이 나오면 성공적으로 도커 컨테이너를 이용한 NTP 서비스가 활성화 된 것이다.

정상 동작 확인하기

$ docker exec ntp chronyc sources

$ docker exec ntp chronyc tracking

$ netstat -lnup

123/udp 포트가 리스닝 상태인지 확인한다.

$ docker exec ntp cat /etc/chrony/chrony.conf

docker-compose.yml 파일에 설정한 NTP_SERVERS의 값이 제대로 설정되어 있는지 확인한다.

$ docker exec ntp date

위 명령어를 입력했을 때 설정한 Timezone에 따라 시간이 현재 시간대로 동기화되어 출력되는지 확인한다.

[FastAPI] Lifespan을 이용한 생명주기 관리 (Event Handler)

limsw — Mon, 26 Feb 2024 22:52:55 +0900

서론

이번 글에서는 FastAPI의 Lifespan을 이용하여 이벤트를 관리하는 방법을 알아보고자 한다.

이 글에서 말하는 이벤트 핸들링은 FastAPI 서비스가 시작 또는 종료될 때 특정 함수를 호출하는 등의 행위를 말한다.

본론

먼저 Lifespan이 생기기 이전에 FastAPI는 on_event를 이용하여 이벤트를 관리했다.

예를 들어, FastAPI가 시작(종료)될 때 특정한 함수를 실행시키기 위해서는 다음과 같이 코드를 작성할 수 있었다.

from fastapi import FastAPI

app = FastAPI()

@app.on_event("startup")
async def startup_event():
    print("service is started.")

@app.on_event("shutdown")
async def shutdown_event():
    print("service is stopped.")

startup : FastAPI가 시작될 때 호출되는 함수
shutdown : FastAPI가 종료될 때 호출되는 함수

위 코드를 실행/종료 했을 때의 결과는 다음과 같다.

Lifespan을 사용하여 생명주기 관리하기

하지만 최근에는 on_event 사용을 지양하고 lifespan을 이용하여 이벤트를 관리하는 방법을 권장하고 있다.

위에서 작성한 코드를 Lifespan을 사용하여 구현하면 다음과 같이 코드를 작성할 수 있다.

from contextlib import asynccontextmanager
from fastapi import FastAPI

def start():
    print("service is started.")
    
def shutdown():
    print("service is stopped.")    

@asynccontextmanager
async def lifespan(app: FastAPI):
    # When service starts.
    start()
    
    yield
    
    # When service is stopped.
    shutdown()

app = FastAPI(lifespan=lifespan)

app 객체를 선언할 때 인자로 lifespan을 정의한다.
yield를 기준으로 앞에 오는 코드는 서비스가 시작될 때 호출되는 함수(코드) 이다.
yield를 기준으로 뒤에 오는 코드는 서비스가 종료될 때 호출되는 함수(코드) 이다.

코드 실행 시 결과는 다음과 같다.

결과는 동일하지만 on_event함수는 공식적으로 지원하지 않는다고 하니, Lifespan을 사용하는 것을 지향한다고 한다.

[Docker] Docker in Docker(DinD) - 도커 컨테이너 안에 도커 사용

limsw — Thu, 22 Feb 2024 11:00:41 +0900

서론

Docker In Docker(DinD)는 실행중인 특정 도커 컨테이너에서 도커를 사용하는 기술이다.

이번 글에서는 DinD를 사용하기 위해 필수적으로 해야하는 설정을 알아보고자 한다.

본론

예를 들어, 도커 컨테이너 안에서 로컬 서버의 도커 컨테이너 목록을 조회하는 기능을 구현한다고 해보자.

우리는 도커 컨테이너 목록을 조회하기 위해 docker ps -a 명령어를 사용한다.

해당 명령어를 기반으로 docker 이미지를 가진 컨테이너에서 docker ps -a 명령어를 수행하려면 다음과 같이 도커 명령어를 작성할 수 있다.

// --rm 명령어는 프로세스 종료 시 컨테이너 자동 제거 옵션
$ docker run --rm docker docker ps -a

이미지를 받고난 후 명령어가 수행되면 다음과 같은 에러가 발생할 것이다.

error during connect: Get "http://docker:2375/v1.24/containers/json?all=1": dial tcp: lookup docker on 8.8.8.8:53: no such host

해당 에러가 발생하는 이유는 로컬의 Docker Daemon에 명령어를 전달하기 위한 소켓(docker.sock)이 존재하지 않아서 발생하는 문제이다.

이를 해결하기 위해서는 도커 컨테이너 시작 시 볼륨 마운트를 통해 문제를 해결할 수 있다.

docker run --rm -v /var/run/docker.sock:/var/run/docker.sock docker docker ps -a

볼륨 마운트 설정을 통한 DinD 기능 구현

위 그림과 같이 도커 컨테이너 안에서 로컬 서버의 도커 컨테이너 목록을 조회할 수 있다.

docker-compose.yml 파일에 볼륨 마운트를 하려면 다음과 같이 작성하면 된다.

services:
  myservice:
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock

[Python] 파이썬으로 도커 컨테이너(Docker Container) 관리하기

limsw — Tue, 20 Feb 2024 16:45:12 +0900

서론

이번 글에서는 파이썬에서 도커 컨테이너를 관리하는 방법에 대해서 알아본다.

라이브러리 설치

pip3 install docker # pip / pip3 적절히 설치

코드 예제1 - 실행중인 도커 컨테이너 목록 및 상태 출력

import docker

def get_docker_container_status():
    try:
        # Create Docker clients
        client = docker.from_env()

        # Import list of running containers
        containers = client.containers.list(all=True)

        # Return Container List and Status
        container_info = {}
        for container in containers:

            container_info[container.name] = {
                'container_id': container.id,
                'status': container.status,
            }

        return container_info

    except docker.errors.APIError as e:
        return f"Error: {e}"

if __name__ == '__main__':
    result = get_docker_container_status()
    print(result)

출력 결과는 다음과 같다.

{
  'sniffer': {
    'container_id': '7c150654117f1624172f010a9cd493beb61f565cff20f0b10e7f792e0afe80fc', 
    'status': 'exited'
    },
  'ntp': {
    'container_id': 'f44ffc41cde7b0c78eedc309a483cc47e79e5386fa85fd7393ee51611e202481', 
    'status': 'running'
    }
 }

코드 예제2 - 컨테이너 이름을 통해 컨테이너 상태 출력

import docker

def get_docker_container_status_using_conName():
    try:
        # Create Docker clients
        client = docker.from_env()

        # 컨테이너 이름을 통해 해당 컨테이너의 객체를 리턴으로 받음
        container = client.containers.get('ntp')

        return {
            'container_id': container.id,
            'status': container.status,
            'container_name': container.name,
            'container_ip': container.attrs['NetworkSettings']['Networks']['docker-ntp_default']['IPAddress']
        }

    except docker.errors.APIError as e:
        return f"Error: {e}"

if __name__ == '__main__':
    result = get_docker_container_status_using_conName()
    print(result)

추가적으로, 컨테이너 IP를 추출할 때 docker-ntp_default가 명시되어 있는 이유는,

docker network ls 명령어를 입력했을 때 나오는 네트워크 이름이다.

출력 결과는 다음과 같다.

{
'container_id': 'f44ffc41cde7b0c78eedc309a483cc47e79e5386fa85fd7393ee51611e202481', 
'status': 'running', 
'container_name': 'ntp', 
'container_ip': '172.21.0.2'
}

코드 예제3 - Exited 상태의 컨테이너 재시작하기

import docker

def restart_stopped_containers(container_name: str):

    try:
         # Create Docker clients
        client = docker.from_env()

        # 컨테이너 이름을 통해 해당 컨테이너의 객체를 리턴으로 받음
        container = client.containers.get(container_name)

        # Restarting a Exited Container
        if container.status == 'exited':
            container.restart()
            return {"status": "Container restarted successfully"}
        else:
            return {"status": "Container is not in 'exited' state, no restart needed"}
        
    except docker.errors.APIError as e:
        return f"Error: {e}"
    
if __name__ == '__main__':
    result = restart_stopped_containers('ntp')
    print(result)

    result = restart_stopped_containers('sniffer')
    print(result)

출력 결과는 다음과 같다.

# container_name : ntp 결과
{'status': "Container is not in 'exited' state, no restart needed"}

# container_name : sniffer 결과
{'status': 'Container restarted successfully'}

재시작 된 컨테이너에 대해서는 docker ps -a 명령어로 확인하면 Up 타임이 최신화 되어 있는 것을 확인할 수 있다.