(オプション)Dockerで試す
要件
ハードウェア
もし自分でDockerイメージをビルドしたい場合は、少なくとも2GBのメモリがマシンにあることを確認してください。 CasdoorのフロントエンドはReactのNPMプロジェクトです。 フロントエンドをビルドするには少なくとも2GBのメモリが必要です。 2GB未満のメモリでは、フロントエンドのビルドに失敗する可能性があります。
もし事前にビルドされたイメージを実行するだけなら、少なくとも100MBのメモリがマシンにあることを確認してください。
OS
すべてのオペレーティングシステム(Linux、Windows、macOS)がサポートされています。
Docker
LinuxではDocker(docker-engineバージョン>= 17.05)を、WindowsとmacOSではDocker Desktopを使用できます。
オペレーティングシステムに関係なく、ユーザーはdocker-engineバージョン>= 17.05を持っていることを確認する必要があります。 これは、docker-compose.ymlでマルチステージビルド機能を利用しており、17.05以降のバージョンでサポートされているためです。 詳細については、https://docs.docker.com/develop/develop-images/multistage-build/を参照してください。
また、docker-composeを使用している場合は、docker-composeバージョン>= 2.2を持っていることを確認してください。 Linuxユーザーの場合、docker-composeがdocker-engineとは別にインストールされていることも確認する必要があります。
画像を取得する
私たちは二つのDockerHubイメージを提供しました:
名前 | 説明 | 提案 |
---|---|---|
casdoor-all-in-one | イメージにはCasdoorとMySQLデータベースが含まれています | このイメージにはおもちゃのデータベースが含まれており、テスト目的のみに使用されます |
casdoor | イメージにはCasdoorのみが含まれています | このイメージは自分のデータベースに接続して、本番環境で使用することができます |
- casbin/casdoor-all-in-one:このイメージにはcasdoorバイナリ、MySQLデータベース、必要なすべての設定が含まれています。 これは、Casdoorをすぐに試したい新しいユーザー向けに設計されています。 このイメージを使用すると、複雑な設定なしで、たった一つか二つのコマンドですぐにCasdoorを起動することができます。 ただし、本番環境でこのイメージを使用することはお勧めしません。
オプション1:おもちゃのデータベースを使用する
ポート8000
をホストに公開してコンテナを実行します。 ローカルホストに存在しない場合、イメージは自動的にプルされます。
docker run -p 8000:8000 casbin/casdoor-all-in-one
ブラウザでhttp://localhost:8000にアクセスします。 デフォルトのグローバル管理者アカウント:built-in/admin
でCasdoorダッシュボードにログインします。
admin
123
オプション2:標準イメージで直接試す
もしコンテナに設定ファイルをマウントすることが不便な場合、環境変数を使用することも可能な解決策です。
docker run \
-e driverName=mysql \
-e dataSourceName='user:password@tcp(x.x.x.x:3306)/' \
-p 8000:8000 \
casbin/casdoor:latest
conf/app.conf
を作成します。 Casdoorのconf/app.confからコピーすることができます。 app.conf
の詳細については、Via Ini fileを参照してください。
次に実行する
docker run -p 8000:8000 -v /folder/of/app.conf:/conf casbin/casdoor:latest
とにかく、app.confを/conf/app.confにマウントしてコンテナを起動します。
ブラウザでhttp://localhost:8000にアクセスします。 デフォルトのグローバル管理者アカウント:built-in/admin
でCasdoorダッシュボードにログインします。
admin
123
オプション3:docker-composeで試す
docker-compose.yml
ファイルと同じディレクトリレベルにconf/app.conf
ディレクトリを作成します。 次に、Casdoorからapp.confをコピーします。 app.conf
の詳細については、Via Ini fileを参照してください。
docker-composeを使用して別のデータベースを作成します:
docker-compose up
それでおしまい! 🛩️
ブラウザでhttp://localhost:8000にアクセスします。 デフォルトのグローバル管理者アカウント:built-in/admin
でCasdoorダッシュボードにログインします。
admin
123
docker-compose.ymlファイルをより深く掘り下げると、「RUNNING_IN_DOCKER」という私たちが作成した環境変数に戸惑うかもしれません。 docker-composeを介して'db'データベースが作成されると、PCのlocalhostには利用可能ですが、Casdoorコンテナのlocalhostには利用可能ではありません。 新しいユーザーにとってはapp.confを変更することが非常に難しい可能性があるため、トラブルに遭遇しないように、この環境変数を提供し、docker-compose.ymlで事前に割り当てました。 この環境変数がtrueに設定されている場合、localhostはhost.docker.internalに置き換えられ、Casdoorがデータベースにアクセスできるようになります。