Keycloak 실행방

프로젝트전공부·2024년 9월 2일

스피링기본

목록 보기
7/8

Keycloak을 Docker에서 실행하는 방법은 매우 간단합니다. 아래의 단계별 가이드를 따라 진행하시면 됩니다.

  1. Keycloak Docker 이미지 Pull
    먼저 Keycloak 이미지를 Docker Hub 또는 Quay.io에서 가져와야 합니다. 명령어는 다음과 같습니다:

bash
코드 복사
docker pull quay.io/keycloak/keycloak
이 명령어는 quay.io에서 Keycloak의 최신 이미지를 가져옵니다.

  1. Keycloak 컨테이너 실행
    Keycloak 컨테이너를 실행하려면 다음 명령어를 사용하세요:
bash
코드 복사
docker run -d --name keycloak -p 8080:8080 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin quay.io/keycloak/keycloak start-dev

여기서 사용된 옵션에 대해 설명드리겠습니다:

-d: 컨테이너를 백그라운드에서 실행합니다.
--name keycloak: 컨테이너 이름을 "keycloak"으로 지정합니다.
-p 8080:8080: 호스트의 포트 8080을 컨테이너의 포트 8080에 바인딩합니다.
-e KEYCLOAK_ADMIN=admin: 관리자 계정의 사용자 이름을 admin으로 설정합니다.
-e KEYCLOAK_ADMIN_PASSWORD=admin: 관리자 계정의 비밀번호를 admin으로 설정합니다.
이 명령어를 실행하면 Keycloak 서버가 시작되고, 웹 인터페이스에 접속할 수 있습니다.

  1. Keycloak에 접속하기
    컨테이너가 정상적으로 실행되면 웹 브라우저에서 다음 주소로 접속할 수 있습니다:

http://localhost:8080

  1. 추가 설정
    Keycloak을 실제 환경에서 사용하려면 데이터베이스 설정, HTTPS 적용, 볼륨 마운트 등을 추가로 설정해야 할 수 있습니다. 예를 들어, PostgreSQL 데이터베이스와 함께 사용하는 경우 다음과 같이 실행할 수 있습니다:

bash
코드 복사
docker run -d --name keycloak -p 8080:8080 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin -e KC_DB=postgres -e KC_DB_URL=jdbc:postgresql://db:5432/keycloak -e KC_DB_USERNAME=keycloak -e KC_DB_PASSWORD=yourpassword quay.io/keycloak/keycloak

위의 예시는 PostgreSQL을 사용하여 Keycloak을 구성하는 방법입니다. db는 PostgreSQL 컨테이너의 이름이며, yourpassword를 실제 비밀번호로 바꿔 사용하시면 됩니다.

  1. 컨테이너 관리
    컨테이너를 중지하거나 다시 시작하려면 다음 명령어를 사용하세요:

bash
코드 복사

컨테이너 중지

docker stop keycloak

컨테이너 다시 시작

docker start keycloak

컨테이너 상태 확인

docker ps -a
이 방법으로 Keycloak을 Docker 환경에서 쉽게 실행하고 관리할 수 있습니다. 추가적으로 궁금한 사항이 있으면 언제든지 문의해주세요!

profile
프로젝트전에 해당 부분을 깊게 공부한것을 올려두는 벨로그

0개의 댓글