절대적 발전

Json, XML, Yaml(yml) 시각화로 편하게 작업하기

일태우 — Sun, 22 Mar 2026 02:03:35 +0900

https://structra.taeu.kr/

Structra - JSON, XML & YAML Data Formatting and Visualization Tool

Free online tool to format, validate, compress and visualize JSON, XML, and YAML data with tree and graph views.

structra.taeu.kr

개발이나 각종 데이터 다루다보면, JSON이나 XML 데이터를 마주할 때가 많음. 이때 별도 설치 없이 브라우저에서 바로 데이터를 정렬하고 분석할 수 있는 Structra 사이트를 소개함(내가 쓰려고 만듬)

1. 주요 기능 및 특징

이 사이트는 단순한 포맷터를 넘어 데이터 구조를 다루는 데 필요한 핵심 기능을 모두 갖추고 있음.

멀티 포맷 지원: JSON은 기본이고, XML과 YAML까지 한 곳에서 처리 가능함.
데이터 정제 (Beautify/Minify): 난잡한 코드를 한눈에 보기 좋게 정렬하거나, 반대로 공백을 제거해 용량을 줄이는 압축 기능을 제공함.
실시간 검증 (Validate): 구문 오류를 즉시 잡아내어 데이터의 무결성을 확인할 수 있음.
트리 뷰 시각화 (Visualize): 텍스트 형태의 데이터를 인터렉티브한 트리 구조로 보여주어 계층 관계 파악이 매우 쉬움.
상호 변환 (Convert): JSON ↔ XML, JSON ↔ YAML 등 포맷 간 변환을 클릭 몇 번으로 해결함.

2. 단계별 사용법

사용법은 매우 직관적이라 누구나 쉽게 따라 할 수 있음.

STEP 1. 데이터 입력 메인 화면의 텍스트 영역에 분석하거나 변환하고 싶은 코드를 복사해서 붙여넣음.

STEP 2. 원하는 도구 선택 상단 메뉴에서 데이터 형식(JSON, XML, YAML)에 맞는 툴을 선택함. 'Format'을 누르면 즉시 예쁘게 정렬됨.

STEP 3. 시각화 및 분석 'Visualize' 탭을 활용해 데이터의 계층 구조를 트리 형태로 펼쳐보며 특정 키(Key)나 값(Value)을 빠르게 찾음.

STEP 4. 결과 활용 정돈된 데이터를 다시 복사해서 프로젝트 코드나 설정 파일에 적용하면 끝임.

Json view

기본적인 트리뷰는 위와 같이 나옴 각 속성별로 클릭해서 볼 수 있고, 마우스를 올리거나 클릭하면 에디터 하이라이팅됨

Graph View

그래프 뷰는 위와 같이 나옴, Json이나 각종 구조화된 데이터를 연관관계를 분석해서 그래프로 표시해줌

난 요즘 각 서비스 환경 설정 하거나 할때 쓰는 설정파일을 편집할때 주로 쓰고, AI 가 주는 결과데이터를 분석할때도 자주씀

이런 컨버팅 기능도 지원하니까 나름 유용하게 쓸 수 있을 것 같다.

window 11 부팅 후 프로그램이 느리게 켜질 때

일태우 — Mon, 15 Sep 2025 03:12:14 +0900

윈도우 11 부팅 후 시작프로그램이 느리게 켜질 때

윈도우 버튼 + R
regedit 입력 + 엔터
[HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Explorer\Serialize] 찾기, Serialize 없으면 키 생성
Dword 추가 (값 수정 필요 없음)
1. StartupDelayInMSec
2. WaitForIdleState

방법을 잘 모르겠으면 아래 파일 실행

부팅느릴때.reg

0.00MB

[Docker] build 시 apk ssl certificate verify failed, apk permission denied 발생 시

일태우 — Thu, 26 Sep 2024 11:35:51 +0900

docker build 시 apk ssl certificate verify failed 혹은 apk permission denied 발생

tls_post_process_server_certificate:certificate verify failed:ssl/statem/statem_clnt.c:2091:
fetching https://dl-cdn.alpinelinux.org/alpine/v3.20/community: Permission denied

alpine 이미지 작업에서 apk add 사용 중에 발생

RUN sed 's/https/http/g' -i /etc/apk/repositories

dockerfile에 위 명령어 추가하여 https를 http로 변경하면 정상처리

헥사고날 아키텍쳐 - 도메인 헥사곤으로 비즈니스 모델링(1)

일태우 — Sun, 18 Aug 2024 21:07:21 +0900

도메인 헥사곤으로 비즈니스 모델링

엔티티를 활용한 문제영역 모델링

도메인 엔티티의 순수성

문제영역 모델링의 주요 초점은 최대한 실제 시나리오를 코드로 변환하는 것, 비즈니스 요구사항을 이해하고 코드로 변환하는데 실패하면 결과적으로 비용의 손실이 발생할 수 밖에 없다

문제영역 모델링의 핵심은 엔티티를 만드는 것이다. 엔티티가 비즈니스 요구사항과 밀접한 관계를 가져야 하기 때문에, 비즈니스 관련 코드와 기술 관련 코드가 혼동되는 것을 방지 해야한다.(기술적: 소프트웨어 맥락에서만 존재하고 의미가 있는 것)

헥사고날 아키텍처는 전통적인 비즈니스 문제를 해결하려는 프로젝트에 초점이 맞춰져 있기 때문에, 새로운 개발 프레임워크와 같은 순수하게 기술적인 프로젝트에는 최선의 접근 방법이 아닐 수도 있다.

도메인 엔티티는 비즈니스 관심사만 처리한다는 점에서 순수해야 한다.

적절하지 않은 엔티티 구성

비즈니스 규칙, 비즈니스 데이터 두 요소는 엔티티의 특징을 결정한다. 비즈니스 데이터만 표현하는 데이터베이스 엔티티 객체와 유사하게 모델링된 엔티티 클래스를 보는 건 드문 일이 아니다.

모델링하려는 엔티티에 본질적이지 않은 로직으로 엔티티 클래스에 과부하를 주면 안된다. 이러한 오퍼레이션에 대해서는 서비스를 통해 수용할 수 있다.

이전 Router클래스에서는 라우터들을 필터링하고 나열하기 위해 retrieveRouter 메서드를 만들었다.

public static List<Router> retrieveRouter(List<Router> routers, Predicate<Router> predicate) {
    return routers.stream()
            .filter(predicate)
            .collect(Collectors.<Router>toList());
}

실제 세계에서 이 동작은 라우터의 본질적인 특성으로 볼 수 없다. 이는 서비스를 통해 수용해야 한다.

public class RouterSearch {

    public static List<Router> retrieveRouter(List<Router> routers, Predicate<Router> predicate) {
        return routers.stream()
                .filter(predicate)
                .collect(Collectors.<Router>toList());
    }
}

도메인 서비스 클래스 RouterSearch에서 이를 수용한다. 이제 retrieveRouter메서드는 도메인 헥사곤과 다른 헥사곤에 있는 다양한 객체들이 서비스로 사용할 수 있다.

isCore, isEdge, filterRouterByType와 같은 도메인 제약사항 메서드는 Router 엔티티 클래스에 계속 유지한다.

UUID를 이용한 식별자 정의

식별자의 중복 생성 및 방지를 위해 데이터베이스 시퀀스에 의존하는 것은 책임을 위임하는 것이며, 중요 부분이 외부와 결합하게 된다. 분리 방법 중 하나는 UUID(universally unique identifier)를 사용하는 것이다.

단점으로는 시퀀스는 정수형태지만 UUID는 문자열이라 리소스를 더 소비한다. 또한 인덱스 관리에 상당한 영향을 줄 수 있다. 이처럼 기술에 구애받지 않는 것 대신 컴퓨터 리소스가 비용으로 들어간다.

엔티티 ID는 한번 정의하고 나면 불변이 되어야 한다. 이러한 불변 속성은 엔티티 ID 속성을 값 객체로 모델링하기에 적합한 후보로 만든다.

public class RouterId {

    private final UUID id;

    public RouterId(UUID id) {
        this.id = id;
    }

    public static RouterId withId(String id) {
        return new RouterId(UUID.fromString(id));
    }

    public static RouterId withoutId() {
        return new RouterId(UUID.randomUUID());
    }
}

도메인 비즈니스의 모든 것이 ID를 갖는 것은 아니므로, 풍부한 도메인 모델을 생성하기 위해서는 엔티티만으로는 충분하지 않다. ID 없는 객체를 표현하기 위한 방법으로 값 객체를 이용한다.

값 객체를 통한 서술력 향상

문제 영역을 모델링하기 위해 내장 타입만 사용하는 것은 충분하지 않다. 비즈니스 본질과 목적을 정확하게 전달하기 위해 우리는 내장타입과 사용자 정의 타입 또한 값 객체로 감싸야 한다.

값 객체는 다음과 같은 특성을 기본으로 한다.

값 객체는 불변이다.
값 객체는 식별자를 갖지 않는다.
폐기 할 수 있어야 한다.
엔티티나 다른 객체 타입을 구성하는 데 쉽게 교체 가능한 객체여야 한다.

값 객체로 엔티티를 구성하면 좋은 예를 알아보자.

public class Event implements Comparable<Event> {
    private EventId id;
    private OffsetDateTime timestamp;
    private String protocol;
    private String activity;
}

activity 필드의 내용을 보면 출발지 호스트와 목적지 호스트를 알 수 있다고 해보자. source.1234 > destination.5555 이와 같이 표현 된다고 했을때 > 기호로 출발지와 목적지를 구분 하고 있다.
이와 같은 방식은 클라이언트에 부담을 주게 된다.

var srcHost = event.getActivity().split(">")[0];

이를 값 객체로 개선 하면 해결 할 수 있다.

public class Activity {
    private String description;
    private final String srcHost;
    private final String dstHost;

    public Activity(String description) {
        this.description = description;
        String[] split = description.split(">");
        this.srcHost = split[0];
        this.dstHost = split[1];
    }

    public String retrieveSrcHost() {
        return this.srcHost;
    }
}

public class Event implements Comparable<Event> {
    private EventId id;
    private OffsetDateTime timestamp;
    private String protocol;
    private Activity activity;
}

그럼 클라이언트의 코드가 명확해지고 표현력도 좋아진다. 또한 임의의 데이터 처리도 필요가 없어진다.

var srcHost = event.getActivity().retrieveSrcHost();

헥사고날 아키텍쳐 - 프레임워크 헥사곤

일태우 — Sun, 4 Aug 2024 21:40:01 +0900

프레임워크 헥사곤

소프트웨어와 통신할 수 있는 기술을 결정한다. 통신은 두 가지 형태로 발생할 수 있다.

드라이빙 방식(Driving): 입력 어댑터(Input Adapter)를 사용한다.
드리븐 방식(Driven): 출력 어댑터(Output Adapter)를 사용한다.

드라이빙 오퍼레이션과 입력 어댑터

드라이빙 오퍼레이션은 소프트웨어에 동작을 요청하는 것이다.

웹 애플리케이션에서 사용자가 버튼 눌러 폼을 제출하는 경우
외부 시스템에서 REST API로 애플리케이션에 데이터를 요청하는 경우
외부 시스템에서 MQ로 메세지를 보내는 경우

이러한 API는 외부 엔티티가 시스템과 상호작용하고, 외부 엔티티의 요청을 도메인 애플리케이션으로 변환하는 방법을 정의한다.

드라이빙이라는 단어는 외부 엔티티들이 시스템의 동작을 유도하기 때문에 쓰인다.

다음은 입력 포트 오퍼레이션 중 stdin을 이용하여 호출 하는 입력 어댑터이다.

public class RouterViewCLIAdapter {

    private RouterViewUseCase routerViewUseCase;

    public RouterViewCLIAdapter() {
        setAdapters();
    }

    public List<Router> obtainRelatedRouters(String type) {
        return routerViewUseCase.getRouters(Router.filterRouterByType(RouterType.valueOf(type)));
    }

    private void setAdapters() {
        this.routerViewUseCase = new RouterViewInputPort(RouterViewFileAdapter.getInstance());
    }
}

유스케이스 인터페이스를 통해 입력 포트를 사용하는 것이 중요한 포인트이다.

명령어를 통해 obtainRelatedRouters를 호출하면 애플리케이션 유스케이스를 호출한다.
입력 데이터 캡슐화: 문자열 형태의 type을 RouterType 열거형으로 변환하여 도메인 엔티티로 캡슐화 한다.
도메인 로직 호출: 변환된 RouterType을 통해 도메인 제약사항을 다룬다.
유스케이스 실행: 필터링된 결과를 routerViewUseCase.getRouters를 통해 비즈니스 로직을 수행한다.

REST 와 같은 다른 통신 형식을 활성화하려면 REST 통신 엔드포인트 노출을 위한 의존성을 포함하는 새로운 REST 어댑터를 생성하면 된다.

드리븐 오퍼레이션과 출력 어댑터

애플리케이션에서 트리거되며, 외부에서 소프트웨어 요구사항을 충족시키는 데 필요한 데이터를 가져온다. 일반적으로 드리븐 오퍼레이션은 일부 드라이빙 오퍼레이션에 응답해 발생한다. 출력 어댑터를 통해서 정의되며 이 어댑터는 그것들을 구현하는 출력 포트와 일치해야 한다.

출력 포트는 애플리케이션 비즈니스를 수행하는 데 필요한 데이터의 종류를 알려주며, 데이터를 어떻게 가져올지 설명하는 것이 출력 어댑터의 역할이다.

도메인 로직에서 처리된 데이터를 데이터베이스에 저장하는 경우
애플리케이션이 외부 API를 호출하여 데이터를 전송하거나 요청하는 경우
도메인 로직이 완료된 후 MQ에 메세지를 보내는 경우

예를 들어 애플리케이션이 오라클 기반 DB로 구성되었다가 Mongo DB로 변경한다고 해보자. 초기에는 오라클 DB와 지속성을 허용하는 출력 어댑터만 가지고 있었다. Mongo와 통신하기 위해 애플리케이션과 도메인 헥사곤은 건들면 안되고, 프레임워크 헥사곤에 출력 어댑터를 생성해야 한다. 입력 어댑터와 출력 어댑터 모두 헥사곤 내부를 가리키고 있기 때문에 이것들을 애플리케이션 및 도메인 헥사곤에 종속되게 만들어 의존성을 역전 시킨다.

드리븐이라는 단어는 헥사고날 애플리케이션 자체에 의해 오퍼레이션이 유도되고 통제되며, 다른 외부 시스템에서 동작을 트리거 하기 때문이다.

public class RouterViewFileAdapter implements RouterViewOutputPort {

    private static RouterViewFileAdapter instance;

    @Override
    public List<Router> fetchRouters() {
        return readFileAsString();
    }

    private static List<Router> readFileAsString() {
        List<Router> routers = new ArrayList<>();
        try (Stream<String> stream = new BufferedReader(
                new InputStreamReader(RouterViewFileAdapter.class.getClassLoader().getResourceAsStream("routers.txt"))).lines()) {
            stream.forEach(line -> {
                String[] routerEntry = line.split(";");
                var id = routerEntry[0];
                var type = routerEntry[1];
                Router router = new Router(RouterType.valueOf(type), RouterId.of(id));
                routers.add(router);
            });
        } catch (Exception e) {
            e.printStackTrace();
        }

        return routers;
    }

    private RouterViewFileAdapter() {

    }

    public static RouterViewFileAdapter getInstance() {
        if (instance == null) {
            instance = new RouterViewFileAdapter();
        }
        return instance;
    }
}

애플리케이션이 외부 데이터를 얻는 방법으로 파일에서 얻는 방법을 출력 어댑터가 출력 포트 인터페이스를 구현하여 정의하는 코드다

이로써 외부 입력 → 입력 어댑터 → 입력 포트 → 유스케이스 → 출력 포트 → 출력 어댑터 → 외부 시스템의 흐름을 살펴 보았다.

헥사고날 아키텍쳐 - 애플리케이션 헥사곤

일태우 — Sun, 4 Aug 2024 20:45:08 +0900

애플리케이션 헥사곤

애플리케이션 특화 작업을 추상적으로 처리하는 곳, 기술 관심사를 직접 다루지 않기 때문에 추상적인 것을 이야기한다. 도메인 비즈니스 규칙에 기반한 소프트웨어 사용자의 의도와 기능을 표현한다.

유스케이스

도메인 제약사항을 지원하기 위해 시스템의 동작을 소프트웨어 영역 내에 존재하는 애플리케이션 특화 오퍼레이션을 통해 나타낸다.

엔티티 및 다른 유스케이스와 직접 상호작용하고 그것을 유연한 컴포넌트로 만들 수 있다.

자바에서는 인터페이스로 정의된 추상화로 나타낸다.

public interface RouterViewUseCase {
    List<Router> getRouters(Predicate<Router> filter);
}

입력 포트

유스케이스 인터페이스를 구현하는 것이 입력 포트의 역할 이다. 애플리케이션 수준에서 유스케이스에 직접 연결되는 컴포넌트이기 때문에 입력 포트는 도메인 용어로 소프트웨어의 의도를 구현할 수 있게 한다.

public class RouterViewInputPort implements RouterViewUseCase {

    private final RouterViewOutputPort routerListOutputPort;

    public RouterViewInputPort(RouterViewOutputPort routerListOutputPort) {
        this.routerListOutputPort = routerListOutputPort;
    }

    @Override
    public List<Router> getRouters(Predicate<Router> filter) {
        var routers = routerListOutputPort.fetchRouters();
        return Router.retrieveRouter(routers, filter);
    }
}

위는 유스케이스에 서술된 소프트웨어의 의도를 구현한 입력 포트다. 도메인 제약사항을 사용해 조회하고자 하는 라우터를 필터링한다.

출력 포트

유스케이스가 목표를 달성하기 위해 외부 리소스에서 데이터를 가져와야 하는 상황이 있다. 이것이 출력 포트의 역할이다.

유스케이스나 입력 포트가 오퍼레이션을 수행하기 위해 어떤 종류의 데이터를 외부에서 가져와야 하는지를 기술에 구애 받지 않고 설명하는 인터페이스로 표현된다.

이 말은 특정 데이터가 DB에서 오든 파일 시스템에서 오든 신경 쓰지 않는 말이다.

public interface RouterViewOutputPort {
    List<Router> fetchRouters();
}

헥사고날 아키텍쳐 - 도메인 헥사곤

일태우 — Sun, 4 Aug 2024 20:18:57 +0900

도메인 헥사곤

실 세계 문제를 이해하고 모델링하는 활동

스타트업 같은 개발자나 도메인 전문가 모두 시스템의 목적에 대한 명확한 비전을 갖고 있지 않거나,

문제 영역이 존재하고 도메인 전문가들이 분명하게 알고 있는 상황에서 문제 영역을 엔티티, 값 객체로의 변환 방법을 파악하지 못하면 잘못된 가정을 기반으로 구축되게 될 것이다.

이러한 점은 소프트웨어가 간단하게 시작해서, 기반 코드가 커짐에 따라 기술 부채가 누적되고 유지 보수가 더 어려워지는 이유 중 하나로 여겨진다.

엔티티

식별자 (Identifier): 엔티티는 고유한 식별자를 가지고 있으며, 이 식별자를 통해 다른 엔티티와 구분된다. 동일한 엔티티는 시간이 지나도 동일한 식별자를 유지한다.
변경 가능성 (Mutability): 엔티티는 시간이 지남에 따라 상태가 변할 수 있다. 이는 엔티티의 특성이 변할 수 있다는 것을 의미한다.
생명 주기 (Lifecycle): 엔티티는 생성되고, 변경되며, 소멸되는 생명 주기를 가진다.

예) 사용자 엔티티는 사용자 ID와 같은 고유 식별자를 가지며, 이름, 이메일과 같은 변하는 속성을 지닌다. 시간이 지남에 따라 사용자의 특성이 변할 수 있다.

값 객체

객체의 정체성보다 속성에 관심을 갖는 경우 코드의 표현력을 보완하는데 도움을 준다.

식별자가 없음 (No Identifier): 값 객체는 고유한 식별자를 가지지 않는다. 자체 속성 값으로 동일성 판단을 한다.
불변성 (Immutability): 값 객체를 사용해 엔티티를 구성할 수 있으므로 도메인 전체에서 예상치 못한 불일치를 방지 하기 위해 불변으로 해야한다.
동등성 (Equality by Value): 두 값 객체가 동일한 속성 값을 가지면, 두 값 객체는 동일한 것으로 간주한다.

헥사고날 아키텍쳐

일태우 — Sun, 4 Aug 2024 20:17:49 +0900

포트와 어댑터 아키텍쳐라고도 불림

메인 아이디어

비즈니스 코드를 기술 코드로부터 분리하는 것
비즈니스 코드에 피해를 주지 않고 기술 코드 변경이 가능해야 한다
핵심 도메인 로직을 외부 인터페이스(입출력, DB, 사용자 인터페이스 등)으로 부터 분리함으로 달성

도메인 헥사곤

소프트웨어가 해결하기를 원하는 핵심 문제를 설명하는 요소의 결합, 이러한 요소들은 기술에 구애 받지 않는 형태로 표현되어야 함

구성 요소
- 엔티티 - 식별자를 할당할 수 있는 것
- 값 객체 - 엔티티들을 합성하기 위한 불변 객체

애플리케이션 헥사곤

도메인 헥사곤에서 나오는 비즈니스 규칙을 사용, 처리, 조정

비즈니스 측면과 기술 측면 사이에서 양쪽과 상호작용하는 중개자 역할

프레임워크 헥사곤

애플리케이션 기능의 노출 방법을 결정, 예를 들면 REST, gRPC 엔드포인트 정의

@EnableScheduling 설정하지 않았는데 Schedule 동작 시

일태우 — Wed, 17 Jan 2024 16:33:04 +0900

@EnableScheduling을 설정하지 않았는데도 Schedule이 동작하고 있을 때 한번 확인해보세요.

전체적으로 라이브러리를 훑어봤는데 Redis Config부분에서 발견되었습니다.

spring-session-data-redis 사용하고, Redis 활성화 시에 RedisHttpSessionConfiguration를 사용하게되는데

아래와 같이 @EnableScheduling이 적용되어 있습니다.

@Configuration
@EnableScheduling
public class RedisHttpSessionConfiguration extends SpringHttpSessionConfiguration
       implements EmbeddedValueResolverAware, ImportAware {

    private Integer maxInactiveIntervalInSeconds = 1800;

    private ConfigureRedisAction configureRedisAction = new ConfigureNotifyKeyspaceEventsAction();

    private String redisNamespace = "";

    private RedisFlushMode redisFlushMode = RedisFlushMode.ON_SAV

참고 해보세요

[Docker] 2. 컨테이너 관리

일태우 — Fri, 17 Jun 2022 15:32:38 +0900

컨테이너 실행하기

컨테이너 실행 명령어는 다음과 같다

docker run [OPTIONS] IMAGE[:TAG|@DIGEST] [COMMAND] [ARG...]

옵션	설명
-d --detach	Detached mode(백그라운드 모드)
-p --publish	호스트와 컨테이너의 포트 연결(포트 포워딩)
-v --volume	호스트와 컨테이너의 디렉토리 연결(파일을 호스트에 바로 저장, 마운트개념)
--rm	프로세스 종료 시 컨테이너 자동 제거
--name	컨테이너 이름 지정
-i --interactive	표준 입력(stdin)을 활성화, bash 사용시 사용
-t --tty	TTY 모드를 사용, bash 사용시 사용, 해당 명령을 사용하지 않으면 명령은 할 수 있겠지만 쉘이 표시되지 않음

Ubuntu 16.04 컨테이너 실행

ubuntu 16.04 이미지 이름을 입력하여 컨테이너 실행, 로컬에 저장되어 있는지 확인하고 없으면 다운로드(pull) 한다.

docker run ubuntu:16.04

별다른 명령을 안했기 때문에 실행중인 프로세스가 없는 ubuntu 컨테이너는 자동 종료된다. 이번에는 /bin/bash를 실행 해보자

docker run -it --rm ubuntu:16.04 /bin/bash

컨테이너가 바로 실행되고 bash를 사용할 수 있게 된다.

cat /etc/issue
Ubuntu 16.04.7 LTS \n \l

ls
bin  boot  dev  etc  home  lib  lib64  media  mnt  
opt  proc  root  run  sbin  srv  sys  tmp  usr  var

컨테이너 실행 시 컨테이너 내부에서 명령어를 실행하기 위해 bash 쉘을 실행했고, 입력을 위해 -it옵션을 추가, 종료시 컨테이너 제거를 위해 --rm옵션을 추가하였다

cat /etc/issue와 ls로 ubuntu환경인 것을 확인 가능하다. exit명령어로 종료와 함께 컨테이너 제거가 된다.

Detached 모드로 Redis 컨테이너 실행

-d 로 Detached 모드로 실행하고, -p 모드로 redis port 6379를 호스트에서 1234로 포워딩하여 실행해보고 exec 명령어로 redis 컨테이너에서 redis-cli를 실행해보자

docker run -d --name redis-test -p 1234:6379 redis

docker exec -it redis-test redis-cli

# in redis-cli
127.0.0.1:6379> keys *
(empty array)
127.0.0.1:6379> set test 1234
OK
127.0.0.1:6379> keys *
1) "test"
127.0.0.1:6379> get test
"1234"

redis-cli로 접근하여 키를 저장해보고 불러보았다 매우 쉽게 redis를 사용해 볼 수 있다

MySQL 5.7 컨테이너 실행

https://hub.docker.com/_/mysql에 들어가면 환경변수에 관한 설명을 참고할 수 있다. 환경변수는 -e 옵션으로 설정한다. --name 옵션으로 컨테이너 이름을 설정하면 다른 명령어에서 쉽게 사용가능하다

docker run -d -p 3306:3306 -e MYSQL_ALLOW_EMPTY_PASSWORD=true --name mysql mysql:5.7

--name 옵션을 생략하면 자동으로 컨테이너이름이 생성되는데, 유명한 과학자나 해커의 이름과 수식어를 조합하여 랜덤으로 생성한다

컨테이너 생성 후 DB 툴로 접속해보자 주소는 localhost:3306 root계정을 이용한다.

mysql 컨테이너에 정상 접속

도커 기본 명령어

컨테이너의 상태를 확인하고, 이미지의 상태를 확인하고 관리해보자

ps - 컨테이너 목록 확인하기

docker ps [OPTIONS]

CONTAINER ID   IMAGE       COMMAND                  CREATED          STATUS          PORTS                               NAMES
cb1c3db80d42   mysql:5.7   "docker-entrypoint.s…"   13 minutes ago   Up 13 minutes   0.0.0.0:3306->3306/tcp, 33060/tcp   mysql
ed9e6c4c1775   redis       "docker-entrypoint.s…"   35 minutes ago   Up 35 minutes   0.0.0.0:1234->6379/tcp              redis-test

docker ps -a

CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS                      PORTS                                       NAMES
cb1c3db80d42   mysql:5.7      "docker-entrypoint.s…"   15 minutes ago   Up 15 minutes               0.0.0.0:3306->3306/tcp, 33060/tcp           mysql
ed9e6c4c1775   redis          "docker-entrypoint.s…"   37 minutes ago   Up 37 minutes               0.0.0.0:1234->6379/tcp                      redis-test
55de267345a0   ubuntu:16.04   "/bin/bash"              2 hours ago      Exited (0) 2 hours ago                                                  nice_ardinghelli

옵션 -a를 사용하면 삭제를 한건 아니기 때문에 종료된 컨테이너도 보인다.

stop - 컨테이너 중지하기

실행중인 컨테이너를 중지한다

docker stop cb1c3db80d42 # 정지할 컨테이너 id 입력

docker ps -a

CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS                      PORTS                                       NAMES
cb1c3db80d42   mysql:5.7      "docker-entrypoint.s…"   20 minutes ago   Exited (0) 3 seconds ago                                                mysql

mysql 컨테이너를 정지해보기 위해 docker ps 명령어로 mysql 컨테이너의 id를 stop 명령어에 입력하자. 참고로 컨테이너 id는 겹치지 않으면 앞의 2자리~4자리만 입력하여도 된다. 해당 컨테이너를 정지하고 다시 ps -a 해보면 정지된 것을 확인 할 수 있다.

rm - 컨테이너 제거하기

종료된 컨테이너를 완전히 제거한다

docker rm [OPTIONS] CONTAINER [CONTAINER...]

docker ps -a

CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS                      PORTS                                       NAMES
cb1c3db80d42   mysql:5.7      "docker-entrypoint.s…"   32 minutes ago   Exited (0) 12 minutes ago                                               mysql
ed9e6c4c1775   redis          "docker-entrypoint.s…"   54 minutes ago   Up 54 minutes               0.0.0.0:1234->6379/tcp                      redis-test
55de267345a0   ubuntu:16.04   "/bin/bash"              3 hours ago      Exited (0) 3 hours ago                                                  nice_ardinghelli

docker rm 55de cb1c

mysql과 ubuntu 컨테이너를 삭제 해보았다. 이후 ps -a로 확인 해보면 삭제된 것을 확인 할 수 있다.

images - 이미지 목록 확인하기

도커가 다운로드한 이미지 목록을 확인한다

docker images [OPTIONS] [REPOSITORY[:TAG]]

REPOSITORY   TAG       IMAGE ID       CREATED        SIZE
redis        latest    604d80444252   3 days ago     117MB
mysql        5.7       2a0961b7de03   2 weeks ago    462MB
ubuntu       16.04     b6f507652425   9 months ago   135MB

이미지 목록과 태크, ID, 생성시점, 용량을 확인 가능하다

pull - 이미지 다운로드

이미지를 다운로드한다

docker pull [OPTIONS] NAME[:TAG|@DIGEST]

docker pull ubuntu:16:04

rmi - 이미지 삭제하기

docker rmi [OPTIONS] IMAGE [IMAGE...]

docker images
REPOSITORY   TAG       IMAGE ID       CREATED        SIZE
redis        latest    604d80444252   3 days ago     117MB
mysql        5.7       2a0961b7de03   2 weeks ago    462MB

docker rmi 2a09

Untagged: mysql:5.7
Untagged: mysql@sha256:7e99b2b8d5bca914ef31059858210f57b009c40375d647f0d4d65ecd01d6b1d5
Deleted: sha256:2a0961b7de03c7b11afd13fec09d0d30992b6e0b4f947a4aba4273723778ed95
Deleted: sha256:2fbd454d39f146da1c0747174089b983c1cf1da7a062384e5a71a94f540141ab
Deleted: sha256:60ce6f6a8d71e66bd7ca1dae1f84a5faedfb993c1a0f352b90597b73eb94d56e
Deleted: sha256:226a653f6ee6b0184d7a6304f29976dc89b0e54e2eec2027d0e3cf87cbe8f2af
Deleted: sha256:218468cc1e9e25a831221617115da837798856793eb7decb3b089c8a1b5bd98f
Deleted: sha256:aea4fcaf4a44b4ce254718a5699557d5a278182a060683e9fcab117281c710c5
Deleted: sha256:87e7690acc799fa14efd95056b81ca599d7587771add57bb73f9066e3a1a1d10
Deleted: sha256:efb1655b4e285047d5fc78392e33a2f0b4156997e69b0833a6b78774674085d6
Deleted: sha256:fabb64857683e1f35472debb5a12a6bf2e081b5766c69874c0528086737434fb
Deleted: sha256:cf7b1ec7aec8704bd8369c4307ecf4931b0afd2d3f912c0a6066c2ac6443ac28
Deleted: sha256:6c9d31c0820816a60a4320711febf8710a1d053f1f3a424e1f071b65263da7d1
Deleted: sha256:10e6bc6fdee2d9a0d1ac5e78a031b5670f37d75599ba609cbd1d027af78f7bf4

실행중인 컨테이너는 이미지의 레이어기반으로 실행되므로 삭제할 수 없다.

컨테이너 둘러보기

logs - 컨테이너 로그보기

컨테이너의 로그를 확인한다

docker logs [OPTIONS] CONTAINER

docker logs redis-test
1:C 17 Jun 2022 07:56:23.572 # oO0OoO0OoO0Oo Redis is starting oO0OoO0OoO0Oo
1:C 17 Jun 2022 07:56:23.572 # Redis version=7.0.2, bits=64, commit=00000000, modified=0, pid=1, just started
1:C 17 Jun 2022 07:56:23.572 # Warning: no config file specified, using the default config. In order to specify a config file use redis-server /path/to/redis.conf
1:M 17 Jun 2022 07:56:23.572 * monotonic clock: POSIX clock_gettime
1:M 17 Jun 2022 07:56:23.573 * Running mode=standalone, port=6379.
1:M 17 Jun 2022 07:56:23.573 # Server initialized
1:M 17 Jun 2022 07:56:23.573 * Ready to accept connections

-tail 옵션으로 출력 라인 수를 지정할 수 있다.

docker logs --tail 5 redis-test
1:C 17 Jun 2022 07:56:23.572 # Warning: no config file specified, using the default config. In order to specify a config file use redis-server /path/to/redis.conf
1:M 17 Jun 2022 07:56:23.572 * monotonic clock: POSIX clock_gettime
1:M 17 Jun 2022 07:56:23.573 * Running mode=standalone, port=6379.
1:M 17 Jun 2022 07:56:23.573 # Server initialized
1:M 17 Jun 2022 07:56:23.573 * Ready to accept connections

-f 옵션으로 실시간으로 로그를 조회할 수 있다.

exec - 컨테이너 명령어 실행하기

컨테이너를 관리하다보면 컨테이너에 접속하여 컨테이너 파일을 실행하고 싶어질 때가 있다. SSH는 권장되지 않는다고 하니 exec명령어를 사용하면 된다.

docker exec [OPTIONS] CONTAINER COMMAND [ARG...]

docker exec -it mysql /bin/bash
root@6fe9822cf342:/# mysql -uroot
Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 2
Server version: 5.7.38 MySQL Community Server (GPL)

Copyright (c) 2000, 2022, Oracle and/or its affiliates.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql> show databases;
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| sys                |
+--------------------+
4 rows in set (0.00 sec)

mysql>

-it 옵션은 키보드 입력을 위해 주었고, bash 쉘로 접속하여 작업을 진행하였다

컨테이너 업데이트

컨테이너를 새로운 버전으로 업데이트 하는 방법은

새 버전 이미지를 다운로드 (pull)
기존 컨테이너 삭제 (stop, rm)
새 컨테이너 생성(run)

과정으로 업데이트 하면 된다. 하지만 mysql 컨테이너를 이렇게 업데이트하면 데이터가 날아갈 것이다. 이를 위해 컨테이너 삭제시 유지해야하는 데이터는 컨테이너 내부가 아닌 외부에 저장하여야 한다.

가장 좋은 방법은 클라우드 서비스(AWS S3 등)을 이용하는 것이고, 데이터 볼륨을 추가하여 호스트의 디렉토리를 마운트해서 사용하는 방법이 있다. run 옵션중 -v 옵션으로 가능하다.

#before
docker run -d -p 3306:3306 -e MYSQL_ALLOW_EMPTY_PASSWORD=true --name mysql mysql:5.72

#after
docker run -d -p 3306:3306 -e MYSQL_ALLOW_EMPTY_PASSWORD=true --name mysql -v c:\test:/var/lib/mysql mysql:5.7

/c/test
$ ls -al
total 188582
drwxr-xr-x 1 twlee 197121        0  6월 17 18:25 ./
drwxr-xr-x 1 twlee 197121        0  6월 17 18:17 ../
-rw-r--r-- 1 twlee 197121       56  6월 17 18:25 auto.cnf
-rw-r--r-- 1 twlee 197121     1112  6월 17 18:25 ca.pem
-rw-r--r-- 1 twlee 197121     1680  6월 17 18:25 ca-key.pem
-rw-r--r-- 1 twlee 197121     1112  6월 17 18:25 client-cert.pem
-rw-r--r-- 1 twlee 197121     1676  6월 17 18:25 client-key.pem
-rw-r--r-- 1 twlee 197121     1352  6월 17 18:25 ib_buffer_pool
-rw-r--r-- 1 twlee 197121 50331648  6월 17 18:25 ib_logfile0
-rw-r--r-- 1 twlee 197121 50331648  6월 17 18:25 ib_logfile1
-rw-r--r-- 1 twlee 197121 79691776  6월 17 18:25 ibdata1
-rw-r--r-- 1 twlee 197121 12582912  6월 17 18:25 ibtmp1
drwxr-xr-x 1 twlee 197121        0  6월 17 18:25 mysql/
drwxr-xr-x 1 twlee 197121        0  6월 17 18:25 performance_schema/
-rw-r--r-- 1 twlee 197121     1676  6월 17 18:25 private_key.pem
-rw-r--r-- 1 twlee 197121      452  6월 17 18:25 public_key.pem
-rw-r--r-- 1 twlee 197121     1112  6월 17 18:25 server-cert.pem
-rw-r--r-- 1 twlee 197121     1676  6월 17 18:25 server-key.pem
drwxr-xr-x 1 twlee 197121        0  6월 17 18:25 sys/

각자의 환경에 맞춰 디렉토리를 변경 해주면 해당 디렉토리로 마운트 되어 파일을 확인 할 수 있다. 이제 컨테이너를 삭제해도 해당 파일은 삭제되지 않으니 컨테이너를 업데이트해도 디렉토리 마운트 후 기존 데이터 그대로 사용할 수 있다.

참고

https://docs.docker.com/engine/reference/run/

https://subicura.com/2017/01/19/docker-guide-for-beginners-2.html