Keycloak Docker Ubuntu 및 CentOS에 설치하기

이번 포스트는 Ubuntu와 CentOS에 Keycloak Docker 를 사용해 빌드 하여 실행하는 방법에 대해 살펴보겠습니다.

목차

1. CentOS에 Keycloak Docker 빌드하기
2. Ubuntu에 Keycloak Docker 빌드하기

1. CentOS에 Keycloak Docker빌드하기

1-1. 혹시 모를 남아있는 Docker 패키지가 있을 수 있으니 완전히 삭제해줍니다.

$ sudo yum remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-engine

1-2. 먼저 yum-utils 를 설치합니다.

yum-utils: yum 패키지 매니저 관련 유틸리티 모음입니다.

sudo yum install -y yum-utils

1-3. Docker 다운 준비를 위한 docker-ce 저장소를 추가합니다.

$ sudo yum-config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo

1-4. Docker 최신 버전을 다운받습니다.

$ sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Note: 특정 버전 다운은 다음 명령을 사용하여 확인 후 다운받습니다.

$ yum list docker-ce --showduplicates | sort -r

$ sudo yum install docker-ce-<VERSION_STRING> docker-ce-cli-<VERSION_STRING> containerd.io docker-buildx-plugin docker-compose-plugin

1-5. Docker를 제대로 다운로드했는지 확인을 위해 버전을 확인해 봅니다.

$ sudo docker -v

1-6. 설치가 완료되었으면 Docker 서비스를 시작합니다.

$ sudo systemctl start docker

서비스 상태를 확인해 봅니다.

1-7. 이제 Docker를 사용하여 Keycloak을 실행합니다.

$ sudo docker run -p 8080:8080 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin quay.io/keycloak/keycloak:21.0.1 start-dev

Note: 초기 admin 사용자를 위한 아이디와 패스워드를 입력합니다.

1-8. 본인 IP:8080 로 접속하여 확인합니다.

1-9. Administration Console을 클릭하여 생성한 아이디와 패스워드로 로그인 합니다.

1-10. 접속이 되는 것을 확인할 수 있습니다.

2. Ubuntu에 Keycloak Docker 빌드하기

2-1. HTTPS를 통해 저장소를 사용할 수 있도록 apt패키지를 업데이트 하고 다음을 설치합니다.

$ sudo apt-get update

$ sudo apt-get install \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

2-2. Docker 공식 GPG 키를 위해 디렉토리를 생성하고 추가합니다.

$ sudo mkdir -m 0755 -p /etc/apt/keyrings

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

2-3. 다음 명령을 사용하여 Docker 저장소를 추가합니다.

$ echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

2-4 apt 패키지를 다시 업데이트합니다.

2-5. 다음 명령어를 사용하여 Docker 최신 버전을 다운받습니다.

$ sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Note: 다른 버전을 다운받고 싶을 때는 아래의 명령을 사용하여 확인 후 다운합니다.

$ apt-cache madison docker-ce | awk '{ print $3 }'

VERSION_STRING=5:20.10.13~3-0~ubuntu-jammy
sudo apt-get install docker-ce=$VERSION_STRING docker-ce-cli=$VERSION_STRING containerd.io docker-buildx-plugin docker-compose-plugin

2-6. 제대로 다운 받아졌는지 Docker 버전을 확인합니다.

$ sudo docker -v

2-7. Docker 서비스가 실행 중 인지 확인합니다.

$ sudo systemctl status docker

2-8. 이제 Docker를 사용하여 Keycloak을 실행합니다.

$ sudo docker run -p 8080:8080 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin quay.io/keycloak/keycloak:21.0.1 start-dev 

Note: 실행하기 앞서 최초 관리자 계정을 생성하기 위해 아이디와 패스워드를 설정합니다.

실행하기 조금 시간이 걸립니다.

2-9. 본인의 IP:8080으로 접속합니다.

2-10. Administration Console을 클릭하여 생성한 아이디와 패스워드를 입력하여 접속합니다.

2-11. 아래와 같이 로그인 되는 것을 확인할 수 있습니다.