本記事で行うこと

Keycloakの起動には開発モードと本番モードの2種類があります。
前回書いた記事では開発モードで起動しましたが、本記事では本番モードで起動してみます。
ただしサーバーやクラウドにはデプロイしません。
ローカル環境でDockerを使用し、httpsとhttpの両方を試します。

開発モードでの起動

bin/kc.[sh|bat] start-dev

本番モードでの起動

bin/kc.[sh|bat] start

Dockerコンテナ

Dockerコンテナはデータベース用とKeycloak用の2種類を用意しました。
後日Keycloak側をクラウドにデプロイするつもりなので、Docker Composeを使わないことにします。

データベースのコンテナ

本記事ではPostgreSQLを使用しました。

Dockerfile


FROM postgres

ENV POSTGRES_DB keycloak
ENV POSTGRES_USER keycloak
ENV POSTGRES_PASSWORD secret

EXPOSE 5432

docker build


docker build ./ -t mygres

docker run


docker run -p 5432:5432 -v /home/user/mydata:/var/lib/postgresql/data mygres

Keycloakコンテナ

httpsで動かすKeycloakコンテナ（オレオレ証明書使用）

Dockerfile

公式サイトのDockerfileを利用しましたが、そのままではうまく動かなかったので、少し変更しました。


FROM quay.io/keycloak/keycloak:latest as builder

# Enable health and metrics support
ENV KC_HEALTH_ENABLED=true
ENV KC_METRICS_ENABLED=true

# Configure a database vendor
ENV KC_DB=postgres

WORKDIR /opt/keycloak
# for demonstration purposes only, please make sure to use proper certificates in production instead
RUN keytool -genkeypair -storepass password -storetype PKCS12 -keyalg RSA -keysize 2048 -dname "CN=server" -alias server -ext "SAN:c=DNS:localhost,IP:127.0.0.1" -keystore conf/server.keystore
RUN /opt/keycloak/bin/kc.sh build

FROM quay.io/keycloak/keycloak:latest
COPY --from=builder /opt/keycloak/ /opt/keycloak/

# Enable health and metrics support
ENV KC_HEALTH_ENABLED=true
ENV KC_METRICS_ENABLED=true

# change these values to point to a running postgres instance
ENV KC_DB=postgres
ENV KC_DB_URL=jdbc:postgresql://host.docker.internal:5432/keycloak
ENV KC_DB_USERNAME=keycloak
ENV KC_DB_PASSWORD=secret
ENV KC_HOSTNAME=localhost

EXPOSE 8443

ENTRYPOINT ["/opt/keycloak/bin/kc.sh", "start"]

docker build


docker build ./ -t mycloak

docker run

初回

環境変数KEYCLOAK_ADMIN（管理ユーザー名）とKEYCLOAK_ADMIN_PASSWORD（管理ユーザーパスワード）を指定しています。


docker run --add-host=host.docker.internal:host-gateway -p 8443:8443 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin mycloak

2回目以降

2回目以降のdocker runで、KEYCLOAK_ADMINを指定すると動かなくなることがありましたので、外しました。


docker run --add-host=host.docker.internal:host-gateway -p 8443:8443 mycloak

httpで動かすKeycloakコンテナ

Dockerfile


FROM quay.io/keycloak/keycloak:latest as builder

# Enable health and metrics support
ENV KC_HEALTH_ENABLED=true
ENV KC_METRICS_ENABLED=true

# Configure a database vendor
ENV KC_DB=postgres

WORKDIR /opt/keycloak
RUN /opt/keycloak/bin/kc.sh build

FROM quay.io/keycloak/keycloak:latest
COPY --from=builder /opt/keycloak/ /opt/keycloak/

# change these values to point to a running postgres instance
ENV KC_DB=postgres
ENV KC_DB_URL=jdbc:postgresql://host.docker.internal:5432/keycloak
ENV KC_DB_USERNAME=keycloak
ENV KC_DB_PASSWORD=secret
ENV KC_HOSTNAME=localhost

EXPOSE 8080
ENV KC_HTTP_PORT=8080
ENV KC_HTTP_ENABLED=true
ENV KC_HOSTNAME_STRICT=false
ENV KC_HOSTNAME_STRICT_HTTPS=false

ENTRYPOINT ["/opt/keycloak/bin/kc.sh", "start"]

docker build

docker build ./ -t mycloak_http

docker run

httpsバージョンとの違い

PORTが8080

docker run --add-host=host.docker.internal:host-gateway -p 8080:8080 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin mycloak_http

動作確認

httpsで動かす

ブラウザで https://localhost:8443 にアクセスします。
オレオレ証明書を使用しているので、以下のように警告が出ます。
「詳細設定」ボタンをクリックします。

「localhost にアクセスする」をクリックします。

「Administration Console」をクリックします。

Sign Inします。

Sign Inできました。以降は通常通り使えました。

httpで動かす

ブラウザで http://localhost:8080 にアクセスします。
httpsバージョンのようにオレオレ証明書に対する警告が出ず、通常通り動きました。

おまけ

試しにKeycloakをCloud Runにデプロイしてみました。
まだ本番では使えない中途半端な状態ですが、一応動いたので、Dockerfileを載せておきます
（何らかの方法で、環境変数KEYCLOAK_ADMINとKEYCLOAK_ADMIN_PASSWORDを設定する必要があります）。


FROM quay.io/keycloak/keycloak:18.0 as builder

# Enable health and metrics support
ENV KC_HEALTH_ENABLED=true
ENV KC_METRICS_ENABLED=true

WORKDIR /opt/keycloak
RUN /opt/keycloak/bin/kc.sh build

FROM quay.io/keycloak/keycloak:18.0

LABEL version="0.1"
LABEL maintainer="***.*** <****@****.com>"

COPY --from=builder /opt/keycloak/ /opt/keycloak/

ENV KC_HTTP_ENABLED=true
ENV KC_HOSTNAME_STRICT=false
ENV KC_HOSTNAME_STRICT_HTTPS=false
ENV KC_HOSTNAME_URL=http://localhost:8080
ENV KC_PROXY=edge

ENTRYPOINT ["/opt/keycloak/bin/kc.sh", "start"]