Keycloak 서버를 성공적으로 다운로드했으며
폴더로 압축을 해제했습니다
그럼 이제 이 ZIP 파일은 필요없으니까
삭제하도록 하겠습니다
자 이제 Keycloak 서버를 설치하려면
어떻게 해야 하는지
Keycloak 사이트로 가서 알아봅시다
이 Keycloak 사이트를 보면
Get Started라는 버튼이 있습니다
이걸 클릭합니다
그러면 Keycloak team에서
다양한 설치 방법에 따른
설치 과정을 설명해 놓았습니다
Docker를 이용한다면 여기
Podman을 이용하면 여기
Kubernetes를 이용하면 여기
Openshift를 이용하면 여기로 가면 됩니다
하지만 지금 저희는
Keycloak를 베어메탈
즉 노트북에 설치하고 싶습니다
그러므로 OpenJDK를 클릭합니다
리눅스나 Mac에서는 이 페이지에 나와 있는 대로
bin 폴더에 들어 있는
kc.sh 셸 스크립트를 실행하면 됩니다
이 'start-dev'라는 코드는
Keycloak 서버를 제품 모드가 아닌
개발 모드로 시작하겠다는 뜻입니다
비슷하게 Windows에서는
bin 폴더에 있는 kc.bat 파일을 호출하면 됩니다
저는 Mac을 이용하고 있기 때문에
셸 스크립트를 실행하겠습니다
만약 Windows 운영체제를 사용하신다면
화면에 나와 있는 명령 중
두 번째를 실행하시면 됩니다
터미널을 열려면
이 폴더를 오른쪽 클릭한 다음
'폴더에서 새로운 터미널 열기'를 선택합니다
이제 위치가 Keycloak 폴더인
새로운 터미널이 열렸습니다
명령어 pwd를 입력해도 터미널의 위치를 알 수 있습니다
올바른 위치에 있다는 것을 알 수 있습니다
이제 실행해야 하는 명령어는 bin/kc.sh입니다
여기서 kc는 Keycloak을 가리킵니다
Windows를 사용 중이라면
bin/kc.bat을 입력해야 합니다
그 다음 한 칸 띄우고
start-dev를 입력합니다
이건 Keycloak 서버를 개발 모드로 시작한다는 뜻입니다
이 서버를 애플리케이션 개발에
바로 활용하지는 않을 것이기 때문에
start-dev를 입력해 주어야 합니다
그 다음 --http-port 8180을 입력합니다
Keycloak의 포트 기본값은 8080인데
이 포트는 Spring Boot 애플리케이션이 이미 사용하고 있습니다
그러므로 기본값 대신
다른 포트를 사용하도록 해야 하는데
--http-port 다음 띄우고
원하는 포트 번호를 입력하면 그 포트를 사용하라는 뜻입니다
저는 Keycloak 서버가
포트 8180에 설치되도록 하였습니다
그래서 이렇게 입력한 겁니다
이 명령을 실행해 보겠습니다
그러면 몇 초 내로
Keycloak 서버가 실행될 겁니다
서버가 성공적으로 실행 시작했습니다
포트 8180에서 listening하고 있고
IP 주소는 0.0.0.0이라는 것도 표시되어 있습니다
이 정보를 알면 로컬 호스트를 통해 서버에 접속할 수 있습니다
그럼 브라우저 안에서 로컬 호스트를 통해
포트 8180으로 접속을 시도하겠습니다
Keycloak 서버에 처음으로 접속하면
이런 페이지가 표시됩니다
관리자 자격 증명을 설정하라고 합니다
사용하고 싶은 관리자 이름과 비밀번호를
여기 입력하면 됩니다
저는 관리자 이름을 admin으로 하고
비밀번호는 무작위로 선택했습니다
같은 비밀번호를 한 번 더 입력합니다
그리고 Create 버튼을 클릭합니다
관리자가 성공적으로 생성되었습니다
이제 이 관리자 콘솔을 클릭하면
자격 증명을 입력할 수 있는
페이지로 재다이렉트 됩니다
아까 설정한 이름과 비밀번호가
관리자 자격 증명입니다
이름 admin과 아까 설정한 비밀번호를 입력합니다
그리고 로그인을 클릭합니다
이제 관리자 콘솔로 접속됩니다
이게 관리자 콘솔입니다
여기서 Keycloak 서버에 관한
여러 설정을 변경할 수 있습니다
여기 있는 설정은 앞으로의 강의에서 전부 다룰 겁니다
하지만 실제 상황에서는
개발자는 이런 설정을 건드릴 일이 생기지 않습니다
Keycloak 서버를 설정하고 URL을 제공하는 일은
개발자인 당신이 아닌
DevOps 팀이나 배포 담당 팀이 맡게 됩니다
하지만 저희는 Keycloak를 이용하여
OAUTH2 프레임워크에 대해 알아보고 싶기 때문에
Keycloak 서버의 기본적인 설치 방법에 대해서도 알려 드리는 겁니다
로컬 시스템에 Keycloak 서버를 어떻게 설치할 수 있는지
이해가 잘 되셨길 바랍니다
들어주셔서 감사하며 다음 강의에서 뵙겠습니다
수고하셨습니다