---
title: "コンテナ環境へのインストール"
canonical: "https://wiki.yellowfin.co.jp/space/yfcurrent/1900892/%E3%82%B3%E3%83%B3%E3%83%86%E3%83%8A%E7%92%B0%E5%A2%83%E3%81%B8%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB"
format: markdown
---
> Macro (anchor)



> Macro (toc)

## 概要

Yellowfinは、Dockerや<span style="color: #000000">Kubernetes</span>の様々なイメージとして使用することができます。いずれのプラットフォームも、ソフトウェアを提供するためにコンテナ技術を使用しています。Yellowfin オールインワンイメージ (ソフトウェアおよびデータベース) と、Yellowfin アプリケーション限定イメージ (ソフトウェアのみ) の2つのコンテナ形式から選択できます。

## Yellowfinのイメージ形式

### Yellowfin オールインワンイメージ

Yellowfin オールインワンイメージには、Yellowfin アプリケーションおよびYellowfin リポジトリデータベース (この場合は、組み込みPostgreSQL データベース) の両方が含まれています。

このイメージは、Docker コンテナの外部にデータを保持せず、コンテナが破棄されるとすべてのコンテンツが失われます。これを念頭に置いて、次の事例を推奨します。

#### 事例

このイメージは、次の事例での使用に最適です。

- 短期でのPOCおよびデモ
- Sandbox環境でのYellowfin機能のテスト

このイメージを次の事例で使用するのは**避けましょう**。

- 本番環境 (コンテナが破棄されるとすべてのコンテンツが失われます)
- クラスタ環境 (このイメージはこの機能をサポートしていません)

#### Yellowfin オールインワンイメージ構成オプション

Yellowfin オールインワンイメージには、構成に使用できる次の環境変数があります。

|  |  |  |
| --- | --- | --- |
| **構成アイテム** | **説明** | **例** |
| アプリケーションメモリ | Yellowfin アプリケーションに割り当てるメモリのメガバイト数を指定します。これが設定されていない場合、YellowfinはJavaのデフォルト値 (通常はシステムRAMの25%) を使用します。 | <span style="color: #000000">-e APP_MEMORY=4096 </span> |

### Yellowfin アプリケーション限定イメージ

Yellowfin アプリケーション限定 イメージには、Yellowfin アプリケーションのみが含まれています。そのため、既存のリポジトリデータベースに接続する必要があります。

このイメージを使用して、単一インスタンス、個別インスタンス、またはYellowfin クラスタ環境に導入することができます。このイメージは、データが外部Yellowfin リポジトリに保持されることで、コンテナが破棄されてもYellowfin データが保持されるため、本番環境および非本番環境の両方に適しています。

#### 事例

このイメージは、次の事例での使用に最適です。

- データの永続性が重要なYellowfinの長期的に使用するインスタンス
- Yellowfin クラスタ環境への導入

#### Yellowfin アプリケーション限定イメージ構成オプション

Yellowfin アプリケーション限定イメージには、構成に使用できる次の環境変数があります。

|  |  |  |
| --- | --- | --- |
| **構成アイテム** | **説明** | **例** |
| JDBC ドライバー名、<span style="color: #000000">JDBC_CLASS_NAME </span> | Yellowfin リポジトリに接続するためのJDBC ドライバークラスを構成します (必須)。 | <span style="color: #000000">-e JDBC_CLASS_NAME=org.postgresql.Driver </span> |
| リポジトリURL、<span style="color: #000000">JDBC_CONN_URL </span> | リポジトリデータベースへの接続URを指定します (必須)。 | <span style="color: #000000">-e JDBC_CONN_URL=jdbc:</span><span style="color: #000000">[postgresql://host:5432/yf](#)</span><span style="color: #000000"> </span> |
| リポジトリユーザー名、<span style="color: #000000">JDBC_CONN_USER </span> | リポジトリデータベースへのアクセスに必要なデータベースユーザーを指定します (必須)。 | <span style="color: #000000">-e JDBC_CONN_USER=dba </span> |
| リポジトリパスワード、<span style="color: #000000">JDBC_CONN_PASS </span> | リポジトリデータベースへのアクセスに必要なデータベースパスワードを指定します。これは暗号化できます (必須)。 | <span style="color: #000000">-e JDBC_CONN_PASS=secret </span> |
| アプリケーションメモリ、<span style="color: #000000">APP_MEMORY</span> | Yellowfin アプリケーションに割り当てるメモリのメガバイト数を指定します。これが設定されていない場合、YellowfinはJavaのデフォルト値 (通常はシステムRAMの25%) を使用します。 | <span style="color: #000000">-e APP_MEMORY=4096 </span> |
| データベースパスワードの暗号化、<span style="color: #000000">JDBC_CONN_ENCRYPTED </span> | データベースパスワードを暗号化するかどうかを指定します (true/false)。 | <span style="color: #000000">-e JDBC_CONN_ENCRYPTED=true </span> |
| コネクションプールサイズ、<span style="color: #000000">JDBC_MAX_COUNT </span> | リポジトリデータベースのコネクションプールの最大サイズを指定します (デフォルトは25)。 | <span style="color: #000000">-e JDBC_MAX_COUNT=25 </span> |
| ようこそページのデフォルト、<span style="color: #000000">WELCOME_PAGE </span> | デフォルトのインデックスページを指定します。 | <span style="color: #000000">-e WELCOME_PAGE=custom_index.jsp </span> |
| 内部アプリケーションHTTP ポート | 内部HTTP ポートを指定します (デフォルトは8080)。 | <span style="color: #000000">-e APP_SERVER_PORT=9090 </span> |
| 内部シャットダウンポート | 内部シャットダウンポートを指定します (デフォルトは8083)。 | <span style="color: #000000">-e TCP_PORT=9093 </span> |
| プロキシポート、<span style="color: #000000">PROXY_PORT </span> | 外部プロキシポートです。 | <span style="color: #000000">-e PROXY_PORT=443 </span> |
| プロキシスキーム、<span style="color: #000000">PROXY_SCHEME </span> | 外部プロキシスキーム (http/https)です。 | <span style="color: #000000">-e PROXY_SCHEME=https </span> |
| プロキシホスト、<span style="color: #000000">PROXY_HOST</span> | 外部プロキシホストまたはIP アドレスです。 | <span style="color: #000000">-e PROXY_HOST=</span><span style="color: #000000">[reporting.company.com](http://reporting.company.com/)</span><span style="color: #000000"> </span> |
| 外部クラスタアドレス、<span style="color: #000000">CLUSTER_ADDRESS </span> | クラスタメッセージ用の外部クラスタアドレスです。通常はDocker HostのホストまたはIPアドレス、またはDocker SwarmおよびKubernetesの場合は、コンテナのDNS名になります。 | <span style="color: #000000">-e CLUSTER_ADDRESS=10.10.10.23</span> |
| 外部クラスタポート、<span style="color: #000000">CLUSTER_PORT</span> | このコンテナが他のノードからクラスタメッセージを受信する一意のTCPポートです。 | <span style="color: #000000">-e CLUSTER_ADDRESS=7801 </span> |
| 内部クラスタネットワークアダプター、<span style="color: #000000">CLUSTER_INTERFACE </span> | クラスタメッセージをバインドするDocker インタフェースを指定します。デフォルトはeth0ですが、KubernetesおよびDocker Swarmでは、これを変更する必要があるかもしれません。 | <span style="color: #000000">-e CLUSTER_INTERFACE=match-interface:eth1 </span> |
| バックグラウンド処理タスクタイプ、<span style="color: #000000">NODE_BACKGROUND_TASKS </span> | このノードで実行できるバックグラウンドタスクタイプのコンマ区切り一覧です。この項目が指定されている場合は、NODE_PARALLEL_TASKSも更新する必要があります。これを指定しない場合、すべてのタスクタイプが有効になります。 | <span style="color: #000000">-e NODE_BACKGROUND_TASKS= FILTER_CACHE,ETL_PROCESS_TASK </span> |
| バックグラウンドタスク処理ジョブ、<span style="color: #000000">NODE_PARALLEL_TASKS </span> | このノードで実行できる各タスクタイプの同時実行タスク数のカンマ区切り一覧です。ここで渡される要素の数は、NODE_BACKGROUND_TASKSによって渡されるタスクタイプ数と一致する必要があります。 | <span style="color: #000000">-e NODE_PARALLEL_TASKS=5,4 </span> |
| 追加ライブラリURL、<span style="color: #000000">LIBRARY_ZIP </span> | Yellowfinのlibフォルダに抽出する追加ライブラリを含むZipファイルのURLです。これを使用して、YellowfinにJDBCドライバーまたはカスタムプラグインを追加できます。パスがアーカイブのzipエントリーに含まれていないことを確認してください。 | <span style="color: #000000">-e LIBRARY_ZIP=h</span><span style="color: #000000">[ttp://lib-](#)</span><span style="color: #000000">host/libraries.zip </span> |

  


---

## Yellowfin イメージのダウンロードおよび構築

Yellowfinは、様々な形式でダウンロードできます。

Yellowfinの主要なインストーラーアプリケーションは、[Yellowfin ポータル](https://support.yellowfin.co.jp/hc/ja/sections/115003324168)から取得できます。

Yellowfin Dockerイメージは、[Docker Hub](https://hub.docker.com/u/yellowfinbi)から取得できます。

(独自のDocker イメージを構築できる) Yellowfinのアセットは、[GitHub](https://github.com/YellowfinBI/Docker)から取得できます。

Yellowfinをアクティベートするにはライセンスが必要です。ライセンスをお持ちでない場合は、評価ライセンスまたはフルライセンスを提供できます。ライセンスの取得をご希望の場合は、[Yellowfin 担当者までお問い合わせください](https://yellowfin.co.jp/campaign/free-trial-try-yellowfin-on-your-own-data-today)。

### Yellowfin GitHub

[GitHubのYellowfinリポジトリ](https://github.com/YellowfinBI/Docker)では、ダウンロード可能なDockerfileとして、YellowfinのDocker イメージが2つ提供されているほか、これらのページでは導入ファイルの例のコピーも提供されています。

Docker イメージを構築するには、次の手順に従います (My_Docker_Registryを、独自のDokcer レジストリ名に置き換えてください)。次の手順では、例として最新のビルドを使用しています。

1. ダウンロードしたYellowfin Dockerfileを、システム内の適切なディレクトリに移動します。
2. [https://support.yellowfin.co.jp/hc/ja/sections/115003324168](https://support.yellowfin.co.jp/hc/ja/sections/115003324168) からYellowfin jar ファイルをダウンロードします。
3. ターミナルを起動し、Yellowfin DockerfileおよびYellowfin jar ファイルが含まれるフォルダーに移動します。
4. ターミナルコマンドを使用して、DockerfileからDocker イメージを構築します。  
<span style="color: #000000">docker build -t yellowfin-app-only</span>
5. ターミナルコマンドを使用して、イメージにバージョンのタグを付けます。  
<span style="color: #000000">docker tag yellowfin-app-only:latest My_Docker_Registry/yellowfin-app-only:latest</span>
6. イメージをDocker レジストリにプッシュします。  
<span style="color: #000000">docker push My_Docker_Registry/yellowfin-app-only:latest </span>

### Yellowfin Docker Hub

構築済みのDocker イメージを直接取得したい場合は、[Yellowfin Docker Hubアカウント](https://hub.docker.com/u/yellowfinbi)が、[Yellowfin アプリケーション限定イメージリポジトリ](https://hub.docker.com/r/yellowfinbi/yellowfin-app-only)および[Yellowfin オールインワンイメージリポジトリ](https://hub.docker.com/r/yellowfinbi/yellowfin-all-in-one)の両方をホストします。いずれもYellowfinの公式リリースビルドに合わせたバージョンになっています。

暫定ビルドが表示される場合がありますが、これらはテストされていない特定のパートナー向けの例外ビルドであるため使用しないでください。

イメージを取得するには、次の表に示すコマンドと接尾辞の組み合わせを使用してください。

|  |  |  |
| --- | --- | --- |
| **イメージ形式** | **コマンド** | **利用可能な接尾辞** |
| オールインワンイメージ | <span style="color: #000000">docker pull yellowfinbi/yellowfin-all-in-one: </span> | `latest `<br>`x.x.x` (例: Yellowfin 9.5.1の場合は`9.5.1、またYellowfin 9.6の場合は9.6.0`) |
| アプリケーション限定イメージ | <span style="color: #000000">docker pull yellowfinbi/yellowfin-app-only: </span> | `latest` (使用には注意が必要です。詳細は以下をご確認ください。)<br>`x.x.x` (例: Yellowfin 9.5.1の場合は`9.5.1、またYellowfin 9.6の場合は9.6.0`) |

例えば、最新のYellowfin オールインワンDocker イメージを取得する場合:

　<span style="color: #000000">docker pull yellowfinbi/yellowfin-all-in-one:latest </span>

または、特定のバージョンのYellowfin アプリケーション限定Docker イメージを取得する場合:

　<span style="color: #000000">docker pull yellowfinbi/yellowfin-app-only:9.5.1 </span>

  


> ✅ 特定のバージョンのYellowfinを使用するには、取得する前にイメージリポジトリの「Tags」項目内で検索します。

> ⚠️ **アプリケーション限定イメージを取得するときは、起動時に誤って更新が実行されないように、 「latest (最新)」 ではなく特定のバージョン番号を使用することを強く推奨します。**

  


---

## 導入例

コンテナ化された導入の形式ごとに記述した手順は、すべての主要なクラウドプロバイダーおよびオンプレミス環境で機能します。

Yellowfinでは、以下のサービスを使用して、Amazon Web Services上でこれらの手順を作成し、テストしました。

- DockerおよびDocker Swarm環境向けEC2インスタンス
- Kubernetes環境向けAWS EKS
- Docker レジストリとしてのAWS ECR (すべての環境向けYellowfin Docker イメージを保存するために使用しました)

可能性は低いですが、他のクラウド環境では導入ファイルへの変更が必要になる場合があります。