Dockerを使用してUbuntu20.04にMetabaseをインストールする方法
序章
Metabase は、Javaベースのオープンソースビジネスインテリジェンス(BI)ツールです。 さまざまなデータベースに接続でき、大規模なSQLクエリの複雑さを隠すことができる質問ビルダーツールを備えています。
このチュートリアルでは、Docker Composeを使用してMetabaseをインストールしてから、NginxをインストールしてMetabaseサイトのリバースプロキシとして機能させます。 次に、Certbotを使用して Let’s Encrypt Certificate Authority からTLS証明書をダウンロードして構成することにより、安全なHTTPS接続を有効にします。 最後に、Metabaseを構成し、いくつかのサンプルデータを読み込んで、独自の質問とBIダッシュボードの作成を試すことができます。
前提条件
このチュートリアルを完了するには、次のものが必要です。
- 2つ以上のCPUを搭載したUbuntu20.04サーバー、sudoアクセス権を持つ非rootユーザー、およびファイアウォール。 これを設定するには、 Ubuntu20.04を使用したサーバーの初期設定チュートリアルに従ってください。
- Dockerがインストールされています。 Ubuntu 20.04にDockerをインストールして使用する方法のステップ1およびステップ2に従って、Dockerをインストールしてroot以外のユーザーを構成します実行できるようにする
docker
コマンド。
注: DigitalOceanのワンクリックDockerイメージを使用している場合は、これらの前提条件をスキップできます。 このイメージは、Docker、Docker Compose、およびUFWで事前構成されています。
選択したリージョンで新しいDockerイメージを起動し、 root ユーザーとしてログインして、チュートリアルを続行します。
最後に、TLSを有効にするには、サーバーのパブリックIPアドレスを指すドメイン名が必要です。 これは次のようなものでなければなりません example.com
また metabase.example.com
. DigitalOceanを使用している場合は、コントロールパネルでドメインリソースを作成する方法について、DNSクイックスタートを参照してください。
すべての前提条件が整ったら、ステップ1 に進み、ここでインストールします。 docker-compose
パッケージ。
ステップ1—DockerComposeをインストールする
をインストールするには docker-compose
コマンドラインツールで、最初にパッケージリストを更新します。
- sudo apt update
次に、を使用してパッケージをインストールします apt
:
- sudo apt install docker-compose
注:Ubuntu20.04に含まれているものよりも新しいDockerComposeパッケージをインストールすることもできます。 これを行うには、 Ubuntu20.04にDockerComposeをインストールして使用する方法のステップ1に従います。
このバージョンのDockerComposeを使用する場合は、代わりに使用する必要があります docker compose
の代わりにコマンドとして docker-compose
このガイド全体。
次のコマンドを実行して、パッケージがインストールされていることを確認できます。
- docker-compose --version
次のような出力を受け取るはずです。
Outputdocker-compose version 1.25.0, build unknown
docker-py version: 4.1.0
CPython version: 3.8.10
Docker Composeがサーバーにインストールされていることを確認したら、それを使用して、このチュートリアルの次のステップでMetabaseを構成して起動します。
ステップ2—DockerComposeを使用してMetabaseを実行する
Metabaseコンテナの作成を開始するには、次のディレクトリを作成します。 metabase
このチュートリアルで作成するファイルを保存するために、ホームディレクトリに保存します。 このディレクトリを使用して、Metabaseを実行するために必要なすべてのファイルを保存します。
次のコマンドを実行して、ディレクトリを作成します。
- mkdir ~/metabase
次に、そこに移動します。
- cd ~/metabase
次に、という新しい空のYAMLファイルを開きます docker-compose.yml
を使用して nano
またはお好みの編集者:
- nano docker-compose.yml
このファイルは docker-compose
Metabaseコンテナを起動するコマンド。 次の行をファイルに追加します。
version: '3'
services:
metabase:
image: metabase/metabase:latest
ports:
- "127.0.0.1:3000:3000"
volumes:
- data:/metabase
volumes:
data:
ファイルは service
と呼ばれる metabase
、Metabaseアプリケーションを実行します。 このサービスは、実行中のコンテナインスタンスの外部にデータを格納するために使用する名前付きボリュームも参照します。 最後に、 metabase
サービスはポートを公開します 3000
サーバー上で同じポートで実行されているMetabaseコンテナに 3000
.
編集が完了したら、ファイルを保存して終了します。 使用している場合 nano
、 押す CTRL+O
それから RETURN
保存してから CTRL+X
出る。
これで、開始する準備ができました metabase
コンテナ docker-compose
指図:
- docker-compose up -d
The up
サブコマンドは docker-compose
で定義されているコンテナと関連するボリュームおよびネットワークを開始します docker-compose.yml
ファイル。 The -d
フラグ(「デーモン化」の略)は docker-compose
コマンドが端末を引き継がないように、コンテナをバックグラウンドで実行します。 docker-compose
必要なDockerイメージをダウンロードしてからコンテナーを起動すると、簡単な出力が出力されます。
OutputCreating network "metabase_default" with the default driver
Creating volume "metabase_data" with default driver
Pulling metabase (metabase/metabase:latest)...
latest: Pulling from metabase/metabase
. . .
Metabaseコンテナをいつでも停止したい場合は、次のコマンドを実行してください。 ~/Metabase
ディレクトリ:
- docker-compose stop
コンテナは停止します。 ボリューム内の構成とデータは保持されるため、次のコマンドでコンテナーを再開できます。 docker-compose up -d
指図。
これが完了すると、Metabaseが実行されているはずです。 Webサーバーがで実行されていることをテストできます 127.0.0.1:3000
を使用してホームページを取得する curl
指図:
- curl --head http://localhost:3000
これにより、応答からHTTPヘッダーのみが出力されます。
OutputHTTP/1.1 200 OK
Date: Tue, 15 Mar 2022 19:26:22 GMT
X-Frame-Options: DENY
X-XSS-Protection: 1; mode=block
Last-Modified: Tue, 15 Mar 2022 19:26:22 GMT
Strict-Transport-Security: max-age=31536000
Set-Cookie: metabase.DEVICE=3525ed6d-13e0-4ad0-8fdb-f1bc426706dc;HttpOnly;Path=/;Expires=Sat, 15 Mar 2042 19:26:22 GMT;SameSite=Lax
X-Permitted-Cross-Domain-Policies: none
Cache-Control: max-age=0, no-cache, must-revalidate, proxy-revalidate
X-Content-Type-Options: nosniff
Content-Security-Policy: default-src 'none'; script-src 'self' 'unsafe-eval' https://maps.google.com https://apis.google.com https://*.googleapis.com *.gstatic.com https://www.google-analytics.com 'sha256-lMAh4yjVuDkQ9NqkK4H+YHUga+anpFs5JAuj/uZh0Rs=' 'sha256-ib2/2v5zC6gGM6Ety7iYgBUvpy/caRX9xV/pzzV7hf0=' 'sha256-JJa56hyDfUbgNfq+0nq6Qs866JKgZ/+qCq2pkDJED8k='; child-src 'self' https://accounts.google.com; style-src 'self' 'unsafe-inline'; font-src 'self' ; img-src * 'self' data:; connect-src 'self' metabase.us10.list-manage.com www.google-analytics.com https://sp.metabase.com ; manifest-src 'self'; frame-ancestors 'none';
Content-Type: text/html;charset=utf-8
Expires: Tue, 03 Jul 2001 06:00:00 GMT
Content-Length: 0
Server: Jetty(9.4.43.v20210629)
The 200 OK
応答とは、アプリケーションがポートで応答していることを意味します 3000
. 強調表示 Set-Cookie
と Server
ヘッダーは、アプリケーションがJettyWebサーバーで実行されているMetabaseであることを確認します。
次に、パブリックトラフィックをMetabaseコンテナにプロキシするようにNginxを設定します。
ステップ3—Nginxのインストールと構成
NginxなどのWebサーバーをMetabaseサーバーの前に配置すると、キャッシュ、圧縮、静的ファイルの提供をより効率的なプロセスにオフロードすることで、パフォーマンスを向上させることができます。 Nginxをインストールし、Metabaseへのリバースプロキシリクエストを構成します。つまり、ユーザーからMetabaseへのリクエストの処理を処理します。 コンテナ化されていないNginxプロセスを使用すると、次のステップでLet’sEncryptTLS証明書を追加するのも簡単になります。
まず、パッケージリストを更新してから、を使用してNginxをインストールします apt
:
- sudo apt install nginx
ポートへのパブリックトラフィックを許可する 80
と 443
(HTTPおよびHTTPS) Nginx Full UFWアプリケーションプロファイルを使用:
- sudo ufw allow "Nginx Full"
OutputRule added
Rule added (v6)
次に、で新しいNginx構成ファイルを開きます /etc/nginx/sites-available
ディレクトリ。 私たちは私たちと呼びます metabase.conf
ただし、別の名前を使用することもできます。
- sudo nano /etc/nginx/sites-available/metabase.conf
以下を新しい構成ファイルに貼り付けます。必ず置き換えてください。 your_domain_here
Metabaseサーバーを指すように構成したドメインを使用します。 これは次のようなものでなければなりません metabase.example.com
、 例えば:
server {
listen 80;
listen [::]:80;
server_name your_domain_here;
access_log /var/log/nginx/metabase.access.log;
error_log /var/log/nginx/metabase.error.log;
location / {
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-Proto https;
proxy_pass http://localhost:3000;
}
}
次のステップでCertbotにTLSの構成を任せるため、この構成は現時点ではHTTPのみです。 構成ファイルの残りの部分は、ログの場所を設定してから、すべてのトラフィックといくつかの重要なプロキシヘッダーを http://localhost:3000
、前の手順で起動したMetabaseコンテナ。
ファイルを保存して閉じ、にリンクして構成を有効にします /etc/nginx/sites-enabled/
:
- sudo ln -s /etc/nginx/sites-available/metabase.conf /etc/nginx/sites-enabled/
使用する nginx -t
構成ファイルの構文が正しいことを確認するには、次のようにします。
- sudo nginx -t
Outputnginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
そして最後に、 nginx
新しい構成でのサービス:
- sudo systemctl reload nginx.service
これで、MetabaseサイトがプレーンHTTPで利用できるようになります。 ロード http://your_domain_here
(セキュリティ警告をクリックする必要があるかもしれません)そしてそれは次のようになります:
サイトがHTTP経由で稼働しているので、CertbotおよびLet’sEncrypt証明書を使用して接続を保護します。 これは、MetabaseのWebベースのセットアップ手順を実行する前に実行する必要があります。
ステップ4—CertbotのインストールとTLS証明書の設定
CertbotとLet’sEncryptの無料認証局のおかげで、MetabaseアプリにTLS暗号化を追加するのに必要なコマンドは2つだけです。
まず、CertbotとそのNginxプラグインをインストールします。
- sudo apt install certbot python3-certbot-nginx
次に、実行します certbot
の --nginx
モードにし、Nginxで使用したものと同じドメインを指定します server_name
構成ディレクティブ:
- sudo certbot --nginx -d your_domain_here
Let’s Encryptの利用規約に同意し、メールアドレスを入力するよう求められます。
その後、すべてのHTTPトラフィックをHTTPSにリダイレクトするかどうかを尋ねられます。 それはあなた次第ですが、これは一般的に推奨され、安全に行うことができます。
その後、Let’s Encryptがリクエストを確認し、Certbotが証明書をダウンロードします。
OutputCongratulations! You have successfully enabled https://metabase.example.com
You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=metabase.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IMPORTANT NOTES:
- Congratulations! Your certificate and chain have been saved at:
/etc/letsencrypt/live/metabase.example.com/fullchain.pem
Your key file has been saved at:
/etc/letsencrypt/live/metabase.example.com/privkey.pem
Your cert will expire on 2022-05-09. To obtain a new or tweaked
version of this certificate in the future, simply run certbot again
with the "certonly" option. To non-interactively renew *all* of
your certificates, run "certbot renew"
- Your account credentials have been saved in your Certbot
configuration directory at /etc/letsencrypt. You should make a
secure backup of this folder now. This configuration directory will
also contain certificates and private keys obtained by Certbot so
making regular backups of this folder is ideal.
- If you like Certbot, please consider supporting our work by:
Donating to ISRG / Let's Encrypt: https://letsencrypt.org/donate
Donating to EFF: https://eff.org/donate-le
Certbotは、新しい構成と証明書を使用してNginxを自動的にリロードします。 ブラウザにサイトをリロードすると、リダイレクトオプションを選択した場合、自動的にHTTPSに切り替わります。
これでサイトは安全になり、Webベースのセットアップ手順を安全に続行できます。
ステップ5—メタベースの設定
Webブラウザーに戻り、ページをリロードします。 これで、安全な方法でMetabaseのデータベース構成ページを開く必要があります。 https://
繋がり。 これで、始めましょうボタンをクリックして、構成プロセスを完了することができます。
次の詳細を入力するように求められます。
- ご希望の言語は何ですか?ご使用の言語がリストにある場合は、その言語を選択して、次のスクリーンショットに従って次へをクリックしてください。
- 何と呼びますか?すべてのフィールドに入力し、安全な場所にパスワードを記録してください。
- データを追加する:ペインの下部にある後でデータを追加しますオプションをクリックします
-
使用状況データの設定:ツールの改善に役立てるために、使用状況データをMetabaseと共有するかどうかを選択します。 選択したら、[完了]をクリックします。
-
これですべての設定が完了しました! Metabaseプロジェクトから更新を受け取りたい場合は、メールアドレスを追加してください。それ以外の場合は、このフィールドを無視してかまいません。
最後に、 Take me toMetabaseボタンをクリックします。 上部に「Greetings、Sammy」と表示されたページが表示されます。このページには、事前に構成された X-Rays のセットがあり、クリックしてロードしたサンプルデータを調べることができます。
X線をクリックして、メタベースのテーブルに関する詳細を表示します。 X線ページのコントロールを使用して、データをフィルタリングしたり、関連するデータベースフィールドやテーブルを調べたりすることができます。
独自の質問(これはMetabaseがクエリを説明するために使用する用語です)を作成する準備ができたら、ページの右上にあるデータの参照グリッドアイコンをクリックします。 サンプルデータベースタイルをクリックし、リストからテーブルをクリックします。 この例では、Reviewsテーブルを使用します。
画面は次のようになります。
次に、ページの右上にある要約ボタンをクリックし、要約フィールドを評価の平均に変更します。 Metabaseは、[評価]フィールドのテーブルのデータに基づいてこの値を計算します。 また、 GroupbyフィールドをCreatedAt に変更します。これにより、Metabaseは、すべてのサンプル製品と評価の1か月あたりの平均製品評価を計算できるようになります。
右下の完了ボタンをクリックすると、次のスクリーンショットのような平均的な製品評価のグラフを表示するページが表示されます。
フィルター、視覚化、および設定ボタンを試して、結果のグラフのグラフ、データ、およびラベルを変更できます。
結論
このチュートリアルでは、DockerComposeを使用してMetabaseBIツールを起動し、Nginxリバースプロキシを設定して、Let’sEncryptTLS証明書を使用して保護しました。 また、いくつかのサンプルデータを追加し、Metabaseで独自の Questions を作成して、データをクエリすることを試みました。
これで、Metabaseを外部データベースに接続して、独自のデータを照会する準備が整いました。 Metabaseは、従来のSQLデータベース、分析エンジン、ドキュメント指向データベースなど、さまざまなデータソースをサポートしています。
Metabaseの使用の詳細については、公式のMetabaseドキュメントを参照してください。