Docker Compose: Makefile을 사용하여 작업 단순화

몇 년마다 소프트웨어 개발 산업은 패러다임 변화를 겪습니다. 이러한 현상 중 하나는 마이크로서비스 개념에 대한 관심이 높아지는 것으로 인식할 수 있습니다. 마이크로서비스는 최신 기술은 아니지만 최근에야 그 인기가 문자 그대로 치솟았습니다.

대규모 모놀리식 서비스는 이제 독립적이고 자율적인 마이크로서비스로 대체되고 있습니다. 마이크로서비스는 매우 구체적인 단일 목적을 제공하는 애플리케이션으로 생각할 수 있습니다. 예를 들어 관계형 DBMS, Express 애플리케이션, Solr 서비스가 될 수 있습니다.

요즘에는 마이크로서비스를 사용하지 않고 새로운 소프트웨어 시스템을 개발하는 것을 상상하기 어렵습니다. 그리고 이러한 상황은 결국 우리를 Docker 플랫폼으로 이끈다.

도커

플랫폼 도커, 마이크로서비스 개발 및 배포에서 거의 업계 표준이 되었습니다. 프로젝트 웹사이트에서 Docker는 조직이 손쉽게 모든 애플리케이션을 생성하고 하이브리드 클라우드부터 엣지 시스템까지 모든 환경에서 이를 배포 및 실행할 수 있게 해주는 유일한 독립 컨테이너화 플랫폼임을 확인할 수 있습니다.

도커 작성

Технология 도커 작성 다중 컨테이너 애플리케이션 구성을 위해 설계되었습니다. Docker Compose 프로젝트에는 프로젝트 작성자가 필요로 하는 만큼 많은 Docker 컨테이너가 포함될 수 있습니다.

Docker Compose로 작업할 때 YAML 파일은 애플리케이션 서비스를 구성하고 서로의 상호 작용을 구성하는 데 사용됩니다. 따라서 Docker Compose는 다중 컨테이너 Docker 애플리케이션을 설명하고 실행하기 위한 도구입니다.

호스트 시스템에서 실행되는 두 개의 컨테이너

GNU 메이크

프로그램 make는 본질적으로 소스 코드에서 프로그램 및 라이브러리 구축을 자동화하는 도구입니다. 일반적으로 우리는 다음과 같이 말할 수 있습니다. make 일부 입력 자료를 일부 출력 형식, 일부 목표로 변환하기 위해 임의의 명령을 실행하는 모든 프로세스에 적용됩니다. 우리의 경우 명령은 docker-compose 추상적인 목표로 변환됩니다(전화 대상).

프로그램을 말하려면 make 우리가 원하는 것이 무엇인지에 대해서는 파일이 필요합니다 Makefile.

우리의 Makefile 일반 명령이 포함됩니다 docker и docker-compose, 이는 많은 문제를 해결하도록 설계되었습니다. 즉, 컨테이너 조립, 시작, 중지, 다시 시작, 컨테이너에 대한 사용자 로그인 구성, 컨테이너 로그 작업 및 기타 유사한 문제 해결에 대해 이야기하고 있습니다.

Docker Compose의 일반적인 사용 사례

다음 구성 요소가 있는 일반 웹 애플리케이션을 상상해 보겠습니다.

• TimescaleDB 데이터베이스(Postgres).
• Express.js 애플리케이션.
• Ping(그냥 컨테이너일 뿐, 특별한 작업은 수행하지 않음)

이 애플리케이션에는 Docker 컨테이너 3개와 파일 XNUMX개가 필요합니다. docker-compose, 이러한 컨테이너를 관리하기 위한 지침이 포함되어 있습니다. 각 컨테이너에는 서로 다른 터치포인트가 있습니다. 예를 들어 컨테이너를 사용하면 timescale 데이터베이스 작업과 거의 동일한 방식으로 작업하는 것이 가능할 것입니다. 즉, 다음 작업을 수행할 수 있습니다.

• Postgres 셸에 로그인합니다.
• 테이블 가져오기 및 내보내기.
• 창조 pg_dump 테이블이나 데이터베이스.

Express.js 애플리케이션 컨테이너, expressjs에는 다음과 같은 기능이 있을 수 있습니다.

• 시스템 로그에서 새로운 데이터를 제공합니다.
• 특정 명령을 실행하려면 셸에 로그인하세요.

컨테이너와 상호작용

Docker Compose를 사용하여 컨테이너 간 통신을 설정했으면 이제 해당 컨테이너와 통신할 차례입니다. Docker Compose 시스템에는 다음 명령이 있습니다. docker-compose, 지원 옵션 -f, 파일을 시스템으로 전송할 수 있습니다. docker-compose.yml.

이 옵션의 기능을 사용하면 파일에 언급된 컨테이너로만 시스템과의 상호 작용을 제한할 수 있습니다. docker-compose.yml.

명령을 사용할 때 컨테이너와의 상호 작용이 어떤 모습인지 살펴보겠습니다. docker-compose. 쉘에 로그인해야 한다고 가정하면 psql, 해당 명령은 다음과 같습니다.

docker-compose -f docker-compose.yml exec timescale psql -Upostgres

실행에 사용되지 않는 동일한 명령 docker-compose과 docker, 다음과 같을 수 있습니다.

docker exec -it  edp_timescale_1 psql -Upostgres

이러한 경우에는 항상 다음 명령을 사용하는 것이 좋습니다. docker, 그리고 명령 docker-compose, 이렇게 하면 컨테이너 이름을 기억할 필요가 없기 때문입니다.

위의 두 명령은 모두 그렇게 어렵지 않습니다. 하지만 다음 형식에 "래퍼"를 사용하면 Makefile, 간단한 명령 형태의 인터페이스를 제공하고 자체적으로 유사한 긴 명령을 호출하면 다음과 같이 동일한 결과를 얻을 수 있습니다.

make db-shell

용도가 분명하다. Makefile 컨테이너 작업이 훨씬 쉬워집니다!

실제 사례

위의 프로젝트 다이어그램을 기반으로 다음 파일을 생성합니다. docker-compose.yml:

version: '3.3'
services:
    api:
        build: .
        image: mywebimage:0.0.1
        ports:
            - 8080:8080
        volumes:
            - /app/node_modules/
        depends_on:
            - timescale
        command: npm run dev
        networks:
            - webappnetwork
    timescale:
        image: timescale/timescaledb-postgis:latest-pg11
        environment:
          - POSTGRES_USER=postgres
          - POSTGRES_PASSWORD=postgres
        command: ["postgres", "-c", "log_statement=all", "-c", "log_destination=stderr"]
        volumes:
          - ./create_schema.sql:/docker-entrypoint-initdb.d/create_schema.sql
        networks:
           - webappnetwork
    ping:
       image: willfarrell/ping
       environment:
           HOSTNAME: "localhost"
           TIMEOUT: 300
networks:
   webappnetwork:
       driver: bridge

Docker Compose 구성을 관리하고 구성이 설명하는 컨테이너와 상호 작용하기 위해 다음 파일을 생성합니다. Makefile:

THIS_FILE := $(lastword $(MAKEFILE_LIST))
.PHONY: help build up start down destroy stop restart logs logs-api ps login-timescale login-api db-shell
help:
        make -pRrq  -f $(THIS_FILE) : 2>/dev/null | awk -v RS= -F: '/^# File/,/^# Finished Make data base/ {if ($$1 !~ "^[#.]") {print $$1}}' | sort | egrep -v -e '^[^[:alnum:]]' -e '^$@$$'
build:
        docker-compose -f docker-compose.yml build $(c)
up:
        docker-compose -f docker-compose.yml up -d $(c)
start:
        docker-compose -f docker-compose.yml start $(c)
down:
        docker-compose -f docker-compose.yml down $(c)
destroy:
        docker-compose -f docker-compose.yml down -v $(c)
stop:
        docker-compose -f docker-compose.yml stop $(c)
restart:
        docker-compose -f docker-compose.yml stop $(c)
        docker-compose -f docker-compose.yml up -d $(c)
logs:
        docker-compose -f docker-compose.yml logs --tail=100 -f $(c)
logs-api:
        docker-compose -f docker-compose.yml logs --tail=100 -f api
ps:
        docker-compose -f docker-compose.yml ps
login-timescale:
        docker-compose -f docker-compose.yml exec timescale /bin/bash
login-api:
        docker-compose -f docker-compose.yml exec api /bin/bash
db-shell:
        docker-compose -f docker-compose.yml exec timescale psql -Upostgres

여기에 설명된 대부분의 명령은 모든 컨테이너에 적용되지만 옵션을 사용하면 c= 명령의 범위를 하나의 컨테이너로 제한할 수 있습니다.

후 Makefile 준비가 되었으면 다음과 같이 사용할 수 있습니다.

• make help — 사용 가능한 모든 명령 목록 발행 make.

사용 가능한 명령에 대한 도움말

• make build - 이미지를 조립하는 중 Dockerfile. 이 예에서는 기존 이미지를 사용했습니다. timescale и ping. 하지만 이미지 api 우리는 현지에서 수집하고 싶습니다. 이것이 바로 이 명령을 실행한 후에 수행되는 작업입니다.

Docker 컨테이너 구축

• make start — 모든 컨테이너를 시작합니다. 하나의 컨테이너만 시작하려면 다음과 같은 명령을 사용할 수 있습니다. make start c=timescale.

기간 컨테이너 실행

핑 컨테이너 실행

• make login-timescale — 컨테이너의 bash 세션에 로그인합니다. timescale.

시간 척도 컨테이너에서 bash 실행

• make db-shell - 입구 psql 용기에 timescale 데이터베이스에 대해 SQL 쿼리를 실행합니다.

timescaledb 컨테이너에서 psql 실행

• make stop — 컨테이너를 중지합니다.

기간 컨테이너 중지

• make down — 컨테이너를 중지하고 제거합니다. 특정 컨테이너를 제거하려면 원하는 컨테이너를 지정하는 이 명령을 사용할 수 있습니다. 예를 들어 - make down c=timescale 또는 make down c=api.

모든 컨테이너 중지 및 삭제

결과

Docker Compose는 컨테이너 관리를 위한 다양한 명령 세트를 제공하지만 때로는 이러한 명령이 길어서 기억하기 어려울 수 있습니다.

사용 방법 Makefile 파일에서 컨테이너와 빠르고 쉽게 상호 작용할 수 있도록 도와주었습니다. docker-compose.yml. 즉, 우리는 다음에 대해 이야기하고 있습니다.

• 개발자는 다음에 설명된 프로젝트 컨테이너하고만 상호 작용합니다. docker-compose.yml, 작업은 실행 중인 다른 컨테이너에 의해 방해받지 않습니다.
• 특정 명령을 잊어버린 경우 해당 명령을 실행할 수 있습니다. make help 사용 가능한 명령에 대한 도움말을 확인하세요.
• 최신 로그 항목을 가져오거나 시스템에 로그인하는 등의 작업을 수행하기 위해 긴 인수 목록을 기억할 필요가 없습니다. 예를 들어 다음과 같은 명령은 docker-compose -f docker-compose.yml exec timescale psql -Upostgres 교대로 make db-shell.
• 파일 Makefile 프로젝트가 성장함에 따라 유연하게 적응할 수 있습니다. 예를 들어 데이터베이스 백업을 생성하거나 다른 작업을 수행하는 명령을 쉽게 추가할 수 있습니다.
• 대규모 개발자 팀이 동일한 것을 사용하는 경우 Makefile, 이를 통해 협업이 간소화되고 오류가 줄어듭니다.

PS 우리의 시장 이미지가 있습니다 도커, 한 번의 클릭으로 설치할 수 있습니다. 컨테이너의 작동을 확인할 수 있습니다. VPS. 모든 신규 고객에게는 3일 동안 무료로 테스트가 제공됩니다.

독자 여러분! Docker Compose를 어떻게 자동화하나요?

출처 : habr.com