- ColdFusion のインストールと設定ユーザーガイド
- ColdFusion のインストール
- ColdFusion サーバープロファイル
- ColdFusion のインストール
- システムの設定
- ColdFusion のライセンスとアクティベーション
- ColdFusion 設定のインストール
- Ansible への ColdFusion のインストール
- 統合テクノロジのインストール
- ColdFusion を設定するには
- ColdFusion の 2023 および 2021 アップデートの JVM 引数
- ColdFusion(2025 リリース)の JVM 引数
- CFSetup 設定ツール
- コマンドラインインターフェイス(CLI)
- ColdFusion の中央管理型サーバー(CCS)
- ColdFusion の管理
- ColdFusion Administrator を使用する
- ColdFusion のデータソース管理
- Webサーバーに接続
- ColdFusion アプリケーションのデプロイ
- ColdFusion セキュリティの管理
- 複数のサーバーインスタンスを使用
- ColdFusion Administrator API リファレンス
概要
Adobe ColdFusion(2025 リリース)のデプロイメントと設定を自動化することで、IT 運用を大幅に効率化し、人的ミスを減らし、環境間で一貫性のあるデプロイメントを実現できます。自動化には他のツールも利用可能ですが、この記事では Ansible の使用に焦点を当てています。ただし、同じワークフローは他の自動化ツールでも適用できます。このプレイブックでは、Ubuntu に Ansible をセットアップし、それを使用して ColdFusion(2025 リリース)のインストールを完全に自動化するためのステップバイステップの手順を提供します。
このプレイブックは、Apache を web サーバーとして使用して Ubuntu 上に ColdFusion(2025 リリース)をデプロイする必要があるシステム管理者、DevOps エンジニア、ColdFusion 開発者向けに設計されています。
前提条件
開始する前に、次のものがあることを確認してください。
- Ubuntu 24 LTS 以降(ターゲットサーバー)
- ターゲットサーバーでの root アクセス権または sudo アクセス権
- コントロールノードとターゲットサーバーの間のネットワーク接続
- Adobe ColdFusion 2025 インストールファイルと有効なライセンスアクティベーションファイル
詳しくは、ColdFusion 2025 サポートマトリックスを参照してください。
必要なファイル
続行する前に、以下のファイルを集めます。
- ColdFusion 2025 インストーラー ZIP ファイル - 自動化に最適な軽量インストーラー。詳しくは、ZIP インストーラーを使用した ColdFusion のインストールを参照してください。
- サイレントインストールプロパティファイル(silent.properties) - ColdFusion サイレントインストールプロパティファイル。詳しくは、ColdFusion のサイレントインストーラープロパティを参照してください。
- ホットフィックスプロパティファイル(hotfix.properties) - ColdFusion 更新インストールプロパティファイル。
- ColdFusion 設定エクスポートファイル(settings.json) - CFsetup を使用して JSON ファイルで ColdFusion 設定をインポートするため。
- ライセンスアクティベーションファイル - ライセンスパッケージ方式を使用して ColdFusion 2025 をアクティベートするため。この記事では、ngl-preconditioning-data.json をアクティベーションファイルとして使用します
Ubuntu への Ansible のインストール
システムパッケージの更新
sudo apt update sudo apt upgrade -y
Ansible のインストール
オプション 1:Ubuntu リポジトリからのインストール
sudo apt install ansible -y
オプション 2:Ansible PPA からのインストール
sudo apt update sudo apt install software-properties-common -y sudo add-apt-repository --yes --update ppa:ansible/ansible sudo apt install ansible -y
オプション 3:pip を使用したインストール
sudo apt install python3-pip -y pip3 install ansible
Ansible のインストールの確認
ansible --version
環境の準備
プロジェクトのディレクトリ構造の作成
mkdir -p ~/coldfusion-ansible/{files,inventory,playbooks}
cd ~/coldfusion-ansible
インベントリファイルの作成
ターゲットサーバーを定義するインベントリファイルの作成:
nano inventory/hosts
サーバーの詳細の追加:
[coldfusion_servers] cf-server ansible_host=192.168.1.100 ansible_user=ubuntu ansible_ssh_private_key_file=~/.ssh/id_rsa [coldfusion_servers:vars] ansible_python_interpreter=/usr/bin/python3
必要なファイルのコピー
cp /path/to/ColdFusion_2025_WWEJ_linux64.zip file cp /path/to/silent.properties file cp /path/to/hotfix.properties file cp /path/to/settings.json file cp /path/to/ngl-preconditioning-data.json file
Ansible プレイブックについて
このプレイブックは、ColdFusion(2025 リリース)のセットアッププロセス全体を次の 8 つの主要フェーズを通じて自動化します。
- ファイルの準備:インストールファイルをターゲットサーバーにコピーします。
- 環境セットアップ:必要なパッケージと依存関係をインストールします。
- ファイアウォールの設定(オプション):必要なポートを開きます。
- ColdFusion のインストール:ColdFusion のサイレントインストール。
- ホットフィックスのインストール:最新の更新をダウンロードして適用します。
- パッケージ管理:ColdFusion パッケージをインストールします。
- 移行:すべての ColdFusion 設定を移行します。
- コネクタの設定:Apache コネクタをセットアップします。
プレイブックのタスク
メインプレイブックの作成
プレイブック YAML ファイルを作成します。
nano playbooks/install-coldfusion.yml
プレイブックの完全な構造は次のとおりです。
- name: ColdFusion 2025 Installation,Hotfix Installation, Migration and Connector Configuration
hosts: coldfusion_servers
become: yes
tasks:
- name: Copy required files to /opt
copy:
src: "{{ item }}"
dest: /opt
loop:
- ColdFusion_2025_WWEJ_linux64.zip
- silent.properties
- hotfix.properties
- settings.json
- name: Install unzip
package:
name: unzip
state: present
- name: Ensure firewalld and firewall Python library are up to date
package:
name:
- firewalld
- python3-firewall
state: latest
- name: Install Apache2
apt:
name: apache2
state: present
update_cache: yes
- name: Ensure Apache2 is running and enabled on boot
systemd:
name: apache2
state: started
enabled: yes
- name: Open Apache port 80 in firewall
firewalld:
port: 80/tcp
permanent: yes
state: enabled
immediate: yes
- name: Unzip ColdFusion installer
ansible.builtin.unarchive:
src: /opt/ColdFusion_2025_WWEJ_linux64.zip
dest: /opt
remote_src: yes
- name: Unzip ColdFusion WWEJ installer again
ansible.builtin.unarchive:
src: /opt/ColdFusion_WWEJ_linux64.zip
dest: /opt
remote_src: yes
- name: Set recursive permissions for /opt/ColdFusion and Configuration files
file:
path: "{{ item.path }}"
mode: "{{ item.mode }}"
recurse: "{{ item.recurse | default(omit) }}"
loop:
- { path: "/opt/ColdFusion", mode: "0755", recurse: yes }
- { path: "/opt/silent.properties", mode: "0644" }
- { path: "/opt/hotfix.properties", mode: "0644" }
- { path: "/opt/settings.json", mode: "0644" }
- name: Install ColdFusion silently
command: /opt/ColdFusion/cfusion/bin/cfinstall.sh -f /opt/silent.properties -i silent
- name: Restart ColdFusion server
command: /opt/ColdFusion/cfusion/bin/coldfusion restart
- name: Open port 8500 in firewall
firewalld:
port: 8500/tcp
permanent: yes
state: enabled
- name: Download hotfix package
get_url:
url: https://cfdownload.adobe.com/pub/adobe/coldfusion/2025/packages/hotfix-packages-cf2025-002-331451.zip
dest: /opt/hotfix-packages-cf2025-002-331451.zip
- name: Create bundles directory
file:
path: /opt/bundles
state: directory
- name: Extract hotfix package
ansible.builtin.unarchive:
src: /opt/hotfix-packages-cf2025-002-331451.zip
dest: /opt/bundles
remote_src: yes
- name: Stop ColdFusion server
command: /opt/ColdFusion/cfusion/bin/coldfusion stop
- name: Copy files to ColdFusion bundles directory
copy:
src: /opt/bundles/
dest: /opt/ColdFusion/bundles/
remote_src: yes
- name: Apply hotfix
command: /opt/ColdFusion/jre/bin/java -jar -Djdk.util.zip.disableZip64ExtraFieldValidation=true /opt/ColdFusion/bundles/updateinstallers/hotfix-002-331451.jar -i silent -f /opt/hotfix.properties
ignore_errors: yes
become: yes # Ensures the command runs as sudo
- name: Install all ColdFusion packages
shell: echo "Y" | ./cfpm.sh update all
args:
chdir: /opt/ColdFusion/cfusion/bin/
become: yes
- name: Import ColdFusion settings
command: /opt/ColdFusion/config/cfsetup/cfsetup.sh import NOSQL /opt/settings.json /opt/ColdFusion/cfusion/ -p=admin@123
args:
chdir: /opt/ColdFusion/config/cfsetup
- name: Configure ColdFusion Apache connector
command: ./wsconfig -ws Apache -dir /etc/apache2/ -bin /usr/sbin/apache2ctl -script /usr/sbin/apache2ctl -v #The path changes as per the Apache installation.
args:
chdir: /opt/ColdFusion/cfusion/runtime/bin
become: yes # Ensures the command runs as sudo
- name: Restart ColdFusion server
command: /opt/ColdFusion/cfusion/bin/coldfusion restart
設定ファイルの作成
サイレントインストールのプロパティ(silent.properties):
#ColdFusion 2025 ZIP インストーラーのサイレントプロパティ # ColdFusion Administrator のパスワード COLDFUSION_ADMIN_PASSWORD=Adobe$123 # 内部 web サーバーポート COLDFUSION_ADMIN_PORT=8500 # インストールライセンスタイプ - 1-ライセンス付きの Adobe ColdFusion 2025 の新しいバージョンのインストール、2-30 日間の体験版、3-デベロッパー版 INSTALL_TYPE=1 # エディション - 1-エンタープライズ、2-スタンダード LICENSE_EDITION=1 # モード - 1-NUL、2-FRL LICENSE_ACTIVATION_MODE=2 # FRL ライセンスファイルパス LICENSE_FILE_PATH=/opt/ngl-preconditioning-data.json # EULA への同意 - true。続行するには、EULA に同意する必要があります EULA_ACCEPTED=true # Administrator にアクセスできる IP アドレス IP_ADDRESSES=*.*.*.* # デプロイメントタイプを指定 - 1-本番、2-開発、3-ステージング、4-テスト、5-災害復旧 DEPLOYMENT_TYPE=3 # ColdFusion サービスの名前 COLDFUSION_WIN_SERVICE_NAME=CF2025 # サーバープロファイル - 1-本番 + セキュア、2-本番、3-開発。 SERVER_PROFILE=2 # RDS パスワードを指定 #COLDFUSION_RDS_PASSWORD=Adobe$123 # ColdFusion のインストール場所 COLDFUSION_INSTALL_LOCATION=/opt/ColdFusion #ColdFusion ランタイムユーザー COLDFUSION_RUNTIME_USER=root
ホットフィックスのプロパティ(hotfix.properties):
INSTALLER_UI=silent USER_INSTALL_DIR=/opt/ColdFusion DOC_ROOT=/opt/ColdFusion/cfusion/wwwroot/ # 以下はマルチサーバーシナリオにのみ適用。 INSTANCE_LIST=ALL
プレイブックの実行
構文チェック
プレイブックを実行する前に構文エラーをチェックします。
ansible-playbook -i inventory/hosts playbooks/install-coldfusion.yml --syntax-check
ドライラン
どのような変更が行われるかを確認するためにドライランを実行します。
ansible-playbook -i inventory/hosts playbooks/install-coldfusion.yml --check
プレイブックの実行
プレイブックを実行します。
ansible-playbook -i inventory/hosts playbooks/install-coldfusion.yml -v
より詳細な出力を得るには、-vv または -vvv を使用します。
プレイブックの進行状況の監視
各タスクの進行状況が表示されます。サーバーの仕様やネットワークの速度にもよりますが、インストールには通常 15~30 分かかります。
インストール後の確認
ColdFusion サービスの確認
ColdFusion が正常に動作しているか確認します。
ps aux | grep coldfusion netstat -tlnp | grep 8500
ColdFusion Administrator のテスト
ColdFusion Administrator にアクセスします。
http://your-server-ip:8500/CFIDE/administrator/index.cfm
CFM ファイル を作成し、実行します。
プレイブックの一部として、web アプリケーションコードを Apache web ルート(例:/var/www/html)にコピーする Ansible タスクを追加できます。