Kompira Enterprise クラウドイメージ
# 1. はじめに
[Kompira Enterprise](https://www.kompira.jp/enterprise/) を簡単にご利用いただけるように、各社クラウド環境で最新の Kompira Enterprise がインストールされたクラウドイメージを提供しています。この資料では Kompira Enterprise クラウドイメージについて説明します。

※ クラウドイメージの提供は Kompira Enterprise v1.6.7 より開始されました。

## 1.1 改版履歴
| 版数 | 日付 | 担当 | 備考 |
| --- | --- | --- | --- |
| 1.0 | 2022/11/21 | FP髙橋 | 初版公開 |
| 1.1 | 2024/06/07 | FP髙橋 | CentOS Stream 8 は EOL につきサポート終了を追記 |
| 1.2 | 2025/04/18 | FP髙橋 | KE 1.6.11 リリースに伴うサポートOS変更に対応しました |

# 2. クラウドイメージについて
## 2.1. クラウドイメージの特徴
最新の Kompira Enterprise をインストール済みの VM イメージを提供しており、VM をデプロイするだけで Kompira Enterprise を使い始めることができます。

- デプロイすると自動的に Kompira Enterprise が起動します。
    - 起動した VM のホスト名または IP アドレスに Web ブラウザでアクセスすると、ログイン画面が表示されます。以下の管理者アカウントでログインすることで Kompira Enterprise をはじめることができます。
        - ユーザ名: `root`
        - パスワード: `root`
- 仮ライセンスが適用されており、デプロイ時から7日間ご利用できます。
    - 期限を過ぎると、新しいオブジェクトの作成やジョブフローの実行などが出来なくなります。
- 継続してご利用される場合はライセンスをご購入していただく必要があります。
    - ライセンスの購入をご検討される際は、以下からお問い合わせください。
        - https://www.kompira.jp/contact/
    - 現状の Kompira Enterprise のライセンスは MAC アドレスを元にサーバを識別しています。ライセンス適用後は、ネットワークインターフェースの差し替えなど MAC アドレスが変更になるような運用にはご注意ください。

## 2.2. Kompira Enterprise の始め方
Kompira Enterprise を初めてご利用になる方は、まずは以下の記事やサイトを参考にされることをお勧めします。

- Kompira Enterprise ジョブフロー作成の超基本
    - https://qiita.com/tomiyoichi/items/1f05b2264cacecb10eca
- Kompira Enterprise スタートガイド
    - https://support.kompira.jp/column/startguide/
- Kompira Enterprise 製品情報
    - https://www.kompira.jp/enterprise/
- Kompira Enterprise 活用方法
    - https://support.kompira.jp/column_category/kompiraenterpriserelation/

Kompira Enterprise にログインすると画面右上にあるリンクからオンラインマニュアルを参照することができます。より詳細な技術情報を知りたい方は、オンラインマニュアルをご活用ください。

また、以下のコミュニティサイトでは分からないことを投稿したり、過去の質問や回答を参照することができます。

- コミュニティサイト
    - https://kompira.zendesk.com/hc/ja/community/topics/360000014321

## 2.3. デプロイ時の注意点
- VM は HTTP サーバ機能を含んでいますが Kompira Enterprise 自体ではネットワークのアクセス制御などは行っておりませんので、インターネット側からのアクセスは制限するようにするなどデプロイ時のネットワーク設定にはご注意ください。
- イメージをデプロイするときに各クラウドで提供される VM のサイズ（CPU数やメモリ量）を指定できます。Kompira Enterprise としては以下のハードウェア構成を要件としていますので参考にしてください。
    - アーキテクチャ: x86_64 のみ対応
    - CPU: 2GHz 以上（2コア以上の構成を推奨します）
    - メモリ: 8GB 以上
    - ディスク: 250GB 以上（長期運用を想定した場合。評価や短期の利用では 20GB 程度でも動作は可能です）
- VM のストレージサイズはベースの OS によって異なります。
    - AWS ではインスタンス作成時にルートボリュームのサイズを拡大することができます。
    - Azure では仮想マシン作成時に OS ディスクを拡大することができません。
        - 外部の記事ですが「[Azure Linux VM の OS ディスク拡張方法](https://jpaztech.github.io/blog/vm/linux-expand-os-disk/)」が参考になるかもしれません。

## 2.4. その他の詳細情報
- 同じ種類の VM を2台用意することで、冗長構成をセットアップすることも可能です。
    - 冗長構成はそのセットアップや構築後の運用が複雑になりますので慎重にご検討ください。
    - 冗長構成の構築に関しては以下の構築ガイドラインを参考になさってください。
        - [Azure での冗長構成の構築ガイドライン](https://docbase.io/posts/1552490/sharing/28572b42-a358-44e9-8ef1-9bbe47233809)
        - [AWS での冗長構成の構築ガイドライン](https://docbase.io/posts/2109239/sharing/338a5440-764e-43d6-93ea-a42ed365ef01)
- VM には Kompira Enterprise のインストールパッケージ（展開済み）とイメージ作成時のインストールログを含んでいます。
    - `/opt/fixpoint/kompira-1.6.*-bin/` に残っています。動作には影響しませんので、不要な場合は削除できます。
- VM にはオフラインパッケージを含んでいます。
    - オフラインパッケージとは Kompira のインストールに必要な RPM パッケージや PIP パッケージを集めたものです。
    - 通常のインストールではインターネットから必要なパッケージをダウンロードしますが、オフラインパッケージを利用することで外部アクセスを遮断した環境でも、再インストールや冗長構成のセットアップを行なうことが可能です。
    - `/opt/kompira/extra/` 配下にオフラインパッケージを含んでいます。不要な場合は削除することでディスクの空き容量（数百MB）を確保することができます。

# 3. プラットフォームごとの詳細情報
## 3.1. Azure 用イメージ
現在 Azure 用のイメージは提供しておりません。

- [2025/04/18] CentOS-7.9 は KE 1.6.11 で新規インストールのサポート対象外になったため、イメージの提供を終了しました。その結果、KE 1.6.11 時点では Azure 用に提供する新規イメージはありません。

## 3.2. AWS 用イメージ
AWS 用のイメージはパブリック AMI で提供していますので、どなたでもご利用いただけます。

### 3.2.1. イメージ一覧
| 名称 | Kompira バージョン | OS バージョン | 管理者アカウント(SSH) | 
| --- | --- | --- | --- |
| Kompira-1.6.X-Amazon-Linux-2023 | 1.6.X | Amazon Linux 2023 | `ec2-user` |
| Kompira-1.6.X-CentOS-Stream-9 | 1.6.X | CentOS Strem 9 | `ec2-user` |

- 各イメージは ap-northeast-1 (東京) リージョンおよび ap-northeast-3 (大阪) リージョンで利用できます。
- 1.6.X の X の部分は Kompira の各バージョンに対応します。
- [2025/04/18] Amazon-Linux-2023 および CentOS-Stream-9 のイメージ提供を開始しました。
- [2025/04/18] CentOS-7.9 および Amazon-Linux-2 は KE 1.6.11 で新規インストールのサポート対象外になったため、イメージの提供を終了しました。
- [2024/06/07] CentOS Stream 8 は EOL につき新規イメージの提供を終了しました。

### 3.2.2. 管理画面での VM 作成方法
AWS の管理画面で VM を作成するときの、Kompira クラウドイメージの選択方法について示します。

#### 3.2.2.1. インスタンスの起動
インスタンスの起動画面で「kompira」と入力してイメージを検索してください。
![image.png](https://image.docbase.io/uploads/9019d0c3-774c-4dbc-82d8-046f7c207185.png =WxH)

#### 3.2.2.2. Kompira イメージの選択
Amazon マシンイメージ (AMI) の選択画面で「コミュニティ AMI」を選択してください。弊社が公開しているイメージが表示されます。
![image.png](https://image.docbase.io/uploads/b93d1a0d-24af-4bd2-9916-843b42d56301.png =WxH)

Kompira のバージョンと OS のバージョンから、ご利用になりたいイメージを選択してください。