> For the complete documentation index, see [llms.txt](https://krjaeh0.gitbook.io/j-log/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://krjaeh0.gitbook.io/j-log/cloud/cloud-devops/docker/docker_hub.md). # Docker\_Hub ## Docker Hub **Docker Hub**는 도커의 공식 레지스트리로, 도커 이미지를 저장하는 저장소입니다. Docker Hub 사용자는 이미지를 자유롭게 업로드하거나 다운 받아 사용합니다. 다른 사용자가 업로드한 이미지 뿐만 아니라 도커에서 제공하는 공식 이미지를 사용할 수 있다는 것도 편리합니다. 공식 이미지는 기본 OS(Linux, CentOS 등) 이미지나, 특정 프로그래밍 언어의 개발 환경 등을 제공합니다. 비공개 이미지를 업로드하여 개인적으로 사용하거나 팀끼리 공유할 수도 있습니다. ![](/files/f59f67091ce029d09400fe608876f993ce5ff38c) ## Docker Hub 이미지 업로드 Docker Hub를 이용하면 Dockerfile이 아닌 이미지 그 자체를 보관하고 공유할 수 있습니다. 자신만의 문제 풀이 환경을 구축해 두고 사용하고 싶거나, 워게임을 직접 제작하여 다른 사람들과 공유하고 싶은 경우 등에 유용합니다. 그럼 Docker Hub 레포지토리에 이미지를 업로드하는 방법을 소개하겠습니다. {% stepper %} {% step %} ### docker login Docker Hub에 로그인합니다. ```bash user@user-VirtualBox:~$ docker login Login with your Docker ID to push and pull images from Docker Hub. If you don't have a Docker ID, head over to https://hub.docker.com to create one. Username: dreamhackofficial Password: WARNING! Your password will be stored unencrypted in /home/user/.docker/config.json. Configure a credential helper to remove this warning. See https://docs.docker.com/engine/reference/commandline/login/#credentials-store Login Succeeded user@user-VirtualBox:~$ ``` {% endstep %} {% step %} ### docker build -t \[사용자]/\[레포지토리명]:\[TAG] \[Dockerfile 경로] Dockerfile을 이용하여 이미지를 빌드합니다. 이미지 이름은 `[사용자]/[레포지토리명]:[TAG]` 형식으로 작성합니다. `dreamhackofficial/exercise-docker:1`을 빌드하겠습니다. ```bash user@user-VirtualBox:~/Desktop/ex-docker$ docker build -t dreamhackofficial/exercise-docker:1 . [+] Building 1.8s (18/18) FINISHED => ...생략... => exporting to image 0.0s => => exporting layers 0.0s => => writing image sha256:9d201c4de2b62519383058265e31669b167c422502643 0.0s => => naming to docker.io/dreamhackofficial/exercise-docker:1 0.0s user@user-VirtualBox:~/Desktop/ex-docker$ docker images REPOSITORY TAG IMAGE ID CREATED SIZE dreamhackofficial/exercise-docker 1 9d201c4de2b6 6 hours ago 122MB ``` {% endstep %} {% step %} ### docker push \[사용자]/\[레포지토리명]:\[TAG] 레포지토리에 이미지를 업로드합니다. ```bash user@user-VirtualBox:~/Desktop/ex-docker$ docker push dreamhackofficial/exercise-docker:1 The push refers to repository [docker.io/dreamhackofficial/exercise-docker] 5f70bf18a086: Pushed 4958ae9bc6ae: Pushed 4b9b1ff53c81: Pushed 5d89cab1df92: Pushed 557171cb0464: Pushed e04c36b2101d: Pushed c8fe798e77a1: Pushed 714c2f225f87: Pushed 60ac9e1e9e64: Pushed 3cc715e175c0: Pushed 0482f429f461: Pushed b93c1bd012ab: Mounted from library/ubuntu 1: digest: sha256:b0288419aa476a56c62d380f41c384f345405b41f7cffffa41aa9c1860fe4617 size: 2818 user@user-VirtualBox:~/Desktop/ex-docker$ ``` Docker Hub의 레포지토리에 이미지가 업로드된 모습입니다. 우측의 명령어를 복사하여 누구나 이미지를 다운받을 수 있습니다. ![](/files/8ba53486d95ee4a76b9cb26df5a3ca193ac8fbfe) ![](/files/19a2040a70e4275b6d1676cab7e3fa0d8ce3f880) {% endstep %} {% endstepper %} ## Docker Hub 이미지 다운로드 Docker Hub에서 이미지는 레포지토리에 보관됩니다. `dreamhackofficial/exercise-docker` 레포지토리에서 앞서 업로드했던 이미지를 다운받을 수 있습니다. {% stepper %} {% step %} ### docker pull `docker pull` 명령어는 Docker Hub에서 이미지를 다운로드합니다. 원하는 레포지토리와 태그를 클릭하여 제공되는 `docker pull` 명령어를 사용합니다. ![](/files/d9c25146158541be69dbb8499f6e76e13558609f) 아래는 `dreamhackofficial/exercise-docker` 레포지토리의 Tag 1 이미지를 성공적으로 다운로드한 모습입니다. 해당 이미지로 컨테이너를 생성하고 실행하여 사용할 수 있습니다. ```bash user@user-VirtualBox:~/Desktop/ex-docker$ docker pull dreamhackofficial/exercise-docker:1 1: Pulling from dreamhackofficial/exercise-docker 2ab09b027e7f: Already exists dae082a9e205: Pull complete ab969aeba5d6: Pull complete cff12ac5c589: Pull complete 3f1e6d67fba6: Pull complete 818905cc8cec: Pull complete 09532c870255: Pull complete 3eda49607555: Pull complete a88f78b4c1db: Pull complete 4ccef51b986d: Pull complete 5cf58cbc005e: Pull complete 4f4fb700ef54: Pull complete Digest: sha256:b0288419aa476a56c62d380f41c384f345405b41f7cffffa41aa9c1860fe4617 Status: Downloaded newer image for dreamhackofficial/exercise-docker:1 docker.io/dreamhackofficial/exercise-docker:1 ``` {% endstep %} {% endstepper %} *** 주어진 컨테이너 정보로 웹 서비스 환경을 다른 사용자에게 공유하려면 실행 중인 컨테이너를 Docker 이미지로 저장하고 이를 Docker Hub에 업로드한 후, 다른 사용자가 이미지를 기반으로 동일한 환경을 실행할 수 있도록 하면 됩니다. 아래는 이를 실현하는 단계별 과정입니다. {% stepper %} {% step %} ### 컨테이너를 이미지로 변환 실행 중인 컨테이너를 이미지로 변환하려면 `docker commit` 명령어를 사용합니다. 각각의 컨테이너를 이미지로 저장합니다. 예시: ```bash docker commit 440197397b4f yourusername/modsecurity-crs:latest ``` (OWASP ModSecurity CRS 컨테이너) {% endstep %} {% step %} ### PHP-FPM 웹 컨테이너 예시 ```bash docker commit 45be39af9f57 yourusername/fakerweb:latest ``` {% endstep %} {% step %} ### MariaDB 데이터베이스 컨테이너 예시 ```bash docker commit 21d976787409 yourusername/mariadb-fakerdb:10.5 ``` {% endstep %} {% step %} ### 이미지 태그 확인 및 수정 `docker images` 명령으로 생성된 이미지를 확인합니다. ```bash docker images ``` 필요하다면 `docker tag` 명령으로 이미지를 적절한 이름과 태그로 수정합니다. {% endstep %} {% step %} ### Docker Hub에 이미지 업로드 1. Docker Hub에 로그인합니다: ```bash docker login ``` 2. 각 이미지를 Docker Hub로 푸시합니다: ```bash docker push yourusername/modsecurity-crs:latest docker push yourusername/fakerweb:latest docker push yourusername/mariadb-fakerdb:10.5 ``` {% endstep %} {% step %} ### docker-compose.yml 공유 이제 도커 허브에 업로드된 이미지를 기반으로 동일한 환경을 실행할 수 있도록 `docker-compose.yml` 파일을 작성하고 공유합니다. 예시: `docker-compose.yml` ```yaml version: '3.9' services: waf: image: yourusername/modsecurity-crs:latest ports: - "8081:80" healthcheck: test: ["CMD", "curl", "-f", "http://localhost"] interval: 30s timeout: 10s retries: 5 web: image: yourusername/fakerweb:latest ports: - "8080:80" db: image: yourusername/mariadb-fakerdb:10.5 environment: MYSQL_ROOT_PASSWORD: root_password MYSQL_DATABASE: fakerdb ``` {% endstep %} {% step %} ### 다른 사용자의 실행 방법 1. Docker Hub 이미지를 가져오기 위해 사용자는 도커를 설치한 상태여야 합니다. 2. 공유받은 `docker-compose.yml` 파일을 다운로드한 후 실행합니다: ```bash docker-compose up ``` 3. 서비스가 실행되면 다음과 같은 환경이 준비됩니다: * WAF (OWASP ModSecurity CRS): * 웹 애플리케이션: * 데이터베이스: 내부 네트워크에서 연결 가능 {% endstep %} {% endstepper %} *** 요약 * 실행 중인 컨테이너를 이미지로 커밋하고 Docker Hub에 업로드. * `docker-compose.yml` 파일을 작성하여 서비스를 정의. * Docker Hub 이미지와 `docker-compose.yml` 파일을 공유하여 다른 사용자가 동일한 환경을 실행. 이 과정은 소스 코드를 직접 공유하지 않고도 서비스를 배포할 수 있는 간단하고 효과적인 방법입니다. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://krjaeh0.gitbook.io/j-log/cloud/cloud-devops/docker/docker_hub.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.