Atlassian Forge入門と2026年開発トレンド完全ガイド

2026年7月26日

お得なお知らせ

スポンサードリンク

タイプ別にすぐ選べる

2026年、ビジネス競争力を上げる2ルート

"組織を動かす"立場と"個人スキルを伸ばす"立場では必要な打ち手が違います。自分の役割で選んでください。

▷ 部門・全社でAIリテラシー研修を入れたい管理職・人事・経営層

【Kindle本】イノベーションOps　組織を動かすDX&AI導入プロセスのすべて

▷ 個人のビジネススキル・思考法を"本から"底上げしたい実務担当者

Kindle Unlimited 30日無料｜ビジネス書読み放題▶

※積極的な自己学習が成長への近道です

▶ 耳で学ぶビジネススキルならオーディオブックAudible 。日経BP・東洋経済系の話題作も対象です。

Contents

1 Atlassian Forge と 2026 年版開発トレンドの全体像
- 1.1 アーキテクチャ差異
- 1.2 2026 年版トレンドとの合致
2 開発環境の準備：アカウント作成から CLI 設置まで
3 最小構成 Hello World プラグインの実装
- 3.1 必要ファイルと主要キー
  - 3.1.1 manifest.yml の抜粋
  - 3.1.2 index.js の抜粋
- 3.2 UI Kit と Custom UI の選び方
4 テストとデプロイ：ローカルシミュレーションから Jira Cloud へ
5 実務活用例と 2026 年版セキュリティ対策
- 5.1 ユースケース例
- 5.2 2026 年版セキュリティチェックリスト
6 トラブルシューティングと公式サポート・コミュニティリソース
7 まとめ
- 7.1 参考文献

スポンサードリンク

Atlassian Forge と 2026 年版開発トレンドの全体像

Forge は Atlassian が提供するサーバーレスプラットフォームで、Jira Cloud・Confluence Cloud 向けのアドオンをコードだけでデプロイできます。近年は「インフラ管理不要」「自動スケール」「統合認証」などが開発現場のキーワードとなっており、これらは 2026 年に向けたクラウドネイティブ開発の主流と一致します。本節では Forge のアーキテクチャを従来方式と比較し、最新トレンドとの親和性を整理します。

アーキテクチャ差異

項目	従来 (Connect / Server)	Atlassian Forge
デプロイ先	ユーザーが管理するサーバー、または Marketplace にパッケージ化	Atlassian のマネージドインフラ（AWS）上のサーバーレス実行環境
スケール方式	手動でインスタンス数やロードバランサを設定	リクエストに応じて自動的にコンテナが増減
インフラ保守	OS パッチ、ミドルウェアアップデートが必須	Atlassian が全て管理し、開発者はコードと権限だけに集中可能
認証・権限	カスタム実装が多く、OAuth 設定ミスによるリスクあり	標準 OAuth 2.0 フローと最小スコープの宣言を `manifest.yml` に記述

ポイント：Forge はインフラ管理負荷を大幅に削減し、開発者が機能実装に注力できる環境です。

2026 年版トレンドとの合致

サーバーレス・ファンクションの普及 – Gartner の「2025 Cloud Development Forecast」では、組織の 70 % がサーバーレスへ移行すると予測されています【^1】。Forge はその代表例です。
API‑First と GraphQL の実装拡大 – Atlassian の公式ロードマップ（2025 Q3）では、REST API v3 をデフォルトとしつつ、GraphQL がベータで提供されていることが示されています【^2】。Forge からは @forge/api ライブラリ経由で最新の REST エンドポイントを利用でき、必要に応じて GraphQL 呼び出しも可能です。
Zero‑Trust セキュリティ – 2024 年の「Atlassian Security Whitepaper」では、最小権限・シークレット管理が標準機能として組み込まれました【^3】。Forge の permissions と forge secrets がこれに該当します。

開発環境の準備：アカウント作成から CLI 設置まで

この章では、Atlassian Developer ポータルで開発者アカウントを取得し、ローカルマシンに Forge CLI をインストールする手順を順番に解説します。数分で「コードを書いてすぐにテストできる」状態が整うので、学習コストが低く抑えられます。

アカウント取得

Atlassian Developer ポータル（https://developer.atlassian.com）へアクセスし、右上の Sign up をクリック。
企業メールアドレスを入力し、受信した認証リンクでアカウントを有効化します。

Node.js と npm のインストール

公式 LTS バージョン（執筆時点 v20.x）を https://nodejs.org から取得
インストール後、以下コマンドでバージョン確認

node -v   # =&gt; v20.xx.x
npm -v    # =&gt; 10.x.x

node -v # => v20.xx.x

npm -v # => 10.x.x

Forge CLI の導入と認証

CLI は npm 経由でグローバルにインストールします。forge login がブラウザを起動し、先ほど作成した Atlassian アカウントでシングルサインオンできます。

npm install -g @forge/cli
forge login          # ブラウザが開き認証完了後にトークンがローカル保存

npm install -g @forge/cli

forge login # ブラウザが開き認証完了後にトークンがローカル保存

プロジェクトの初期化

対話式テンプレート選択で jira-issue-panel などを指定すると、必要なファイル構成が自動生成されます。

forge create          # テンプレート選択 → ディレクトリ作成完了

1 2	forge create # テンプレート選択 → ディレクトリ作成完了

ポイント：上記手順を完了すれば、数分で「コードを書いて forge deploy」できる環境が整います。

最小構成 Hello World プラグインの実装

ここでは最もシンプルなプラグインを作成するために必要なファイルと設定項目だけを紹介します。UI Kit と Custom UI の選択基準も合わせて示すので、次の開発フェーズへスムーズに移行できます。

必要ファイルと主要キー

ファイル	重要ポイント
`manifest.yml`	アプリ全体のメタ情報・権限（例: `read:jira-work`）・モジュール定義 (`jira:issuePanel`) を記述
`src/index.js`	エントリ関数 `run` が UI Kit の `render` を返すだけのシンプル実装

manifest.yml の抜粋

modules:
  jira:issuePanel:
    - key: hello-world-panel
      function: main
      title: Hello World
      description: Simple panel rendered with UI Kit
permissions:
  scopes:
    - read:jira-work
resources:
  - name: ui-kit
    type: static
    path: static/
functions:
  main:
    handler: src/index.run

modules:

jira:issuePanel:

- key: hello-world-panel

function: main

title: Hello World

description: Simple panel rendered with UI Kit

permissions:

scopes:

- read:jira-work

resources:

- name: ui-kit

type: static

path: static/

functions:

main:

handler: src/index.run

index.js の抜粋

import { render, Fragment } from '@forge/ui';

export const run = async () =&gt; {
  return render(
    &lt;Fragment&gt;
      Hello World from Forge!
    &lt;/Fragment&gt;
  );
};

import { render, Fragment } from '@forge/ui';

export const run = async () => {

return render(

Hello World from Forge!

</Fragment>

);

};

UI Kit と Custom UI の選び方

UI Kit：テキスト・ボタン・簡易リストなど、アクセシビリティが自動的に提供される軽量 UI。開発速度が最速です。
Custom UI（React）：外部ライブラリや高度なインタラクションが必要な場合は customUI モジュールを追加し、src/custom-ui/ に React アプリを配置します。ローカルデバッグは forge tunnel が有効です。

ポイント：まず UI Kit で実装し、要件が拡張された段階で Custom UI に移行するのがコスト最適化のベストプラクティスです。

テストとデプロイ：ローカルシミュレーションから Jira Cloud へ

本章では Forge が提供するエミュレータ、forge tunnel を使ったリアルタイムテスト、そして安全な本番リリース手順を詳述します。CI/CD パイプラインへの組み込み例も併せて示すので、チーム開発でもスムーズに運用できます。

ローカルエミュレータでの検証

forge start でローカルサーバーが起動し、ブラウザ上のテストインスタンスにプラグインが自動的にロードされます。コード変更は即座に反映され、デバッグが高速です。

forge start   # ローカルエミュレータ起動

1 2	forge start # ローカルエミュレータ起動

`forge tunnel` によるリアルタイムテスト

本番と同一の Jira Cloud 環境でローカルコードをプレビューできるので、API 呼び出しや UI の挙動を正確に確認できます。

forge tunnel   # ローカルサーバーが HTTPS 経由でクラウドにトンネル

1 2	forge tunnel # ローカルサーバーが HTTPS 経由でクラウドにトンネル

バージョン管理とリリースフロー

フェーズ	推奨 Git 操作
開発ブランチ	`feature/*` で機能追加、プルリクエスト時に自動テスト (`forge start`) を走らせる
安定化ブランチ	`release/*` にマージ後、タグ付与（例: `v1.0.0`）と CHANGELOG 更新
本番デプロイ	タグ作成をトリガーに CI が `forge deploy --environment production` を実行

デプロイ手順

# 環境変数やシークレットが最新か確認
forge secrets list

# 本番環境へデプロイ
forge deploy --environment production

# 環境変数やシークレットが最新か確認

forge secrets list

# 本番環境へデプロイ

forge deploy --environment production

デプロイ完了後は Atlassian 管理コンソールでアプリの有効化状態をチェックし、必要に応じてリリースノートを forge release で生成します。

ポイント：ローカルエミュレータ → tunnel デバッグ → Git ベースの CI/CD が標準的な開発フローです。

実務活用例と 2026 年版セキュリティ対策

本節では Forge を活用した具体的ユースケースと、2026 年に求められる最新のセキュリティ要件をまとめます。API バージョン管理やシークレット保護のベストプラクティスも併せて示します。

ユースケース例

シナリオ	実装概要（Forge Function）	期待効果
カスタムフィールド自動生成	`issueCreated` イベントで外部 DB と連携し、プロジェクト固有のカスタムフィールドを作成	フィールド設定工数が約 70 % 短縮
ステータス遷移時の自動割当て	`workflowTransitioned` ハンドラで担当者をローテーションアルゴリズムに基づき変更	SLA 達成率が 15 % 向上
AI アシスタント連携（2026 年トレンド）	カスタム UI のボタンから OpenAI API を呼び出し、課題要約を自動生成	記述時間が平均 30 秒短縮【^4】

2026 年版セキュリティチェックリスト

OAuth スコープの最小化 – manifest.yml の permissions.scopes に必要最低限だけ列記。例: read:jira-work, write:jira-work。
シークレット管理 – forge secrets set <KEY>=<value> で環境変数を暗号化保存し、コードベースに平文を書かない。
IP アドレス制限（Zero‑Trust） – Atlassian 管理コンソールの「IP Allowlist」機能で社内ネットワークのみアクセス許可。
API バージョン対応 – @forge/api は常に最新バージョンを使用し、apiVersion: "3" を明示（REST API v3 が推奨）【^2】。
コードレビューと静的解析 – GitHub Actions で eslint と npm audit を走らせ、脆弱性を早期に検出。

ポイント：上記項目をすべて満たすことで、2026 年の「Zero‑Trust」基準に適合した安全な Forge アプリが完成します。

トラブルシューティングと公式サポート・コミュニティリソース

開発中に遭遇しやすいエラーとその対処法、さらに Atlassian が提供する公式ドキュメントやコミュニティの活用方法をまとめます。自己解決できる範囲が広がれば、開発スピードも大幅に向上します。

よくあるエラーと対応策

エラーコード	主な原因	推奨対処
`FORGE_AUTH_ERROR`	認証トークンの有効期限切れまたはスコープ不足	`forge logout && forge login` で再認証し、`manifest.yml` の権限を見直す
`FORGE_DEPLOY_FAILED`	`permissions` が不足しているか、リソースパスが不正	`manifest.yml` の `permissions` と `resources` を確認。必要に応じて `forge deploy --debug` で詳細ログ取得
`MODULE_NOT_FOUND`	依存パッケージのインストール漏れ	プロジェクトルートで `npm ci`（CI 環境向け）または `npm install` を再実行
`FORGE_TUNNEL_TIMEOUT`	ネットワーク制限やプロキシ設定が原因	社内 VPN/Proxy の例外リストに `*.forge.dev` を追加し、再度 `forge tunnel` 起動

デバッグフロー

ログ取得
bash forge logs --tail # リアルタイムでスタックトレースを確認
デバッグモード有効化（環境変数）
bash export FORGE_DEBUG=true forge deploy # 詳細エラーメッセージが出力される
ローカル再現テスト – forge start で問題のシナリオを再現し、コンソールに出力された情報から原因を特定。

公式・コミュニティリソース

リソース	URL
Atlassian 公式サポートページ	https://support.atlassian.com
Forge 開発者ドキュメント（最新）	https://developer.atlassian.com/forge/
Atlassian Community フォーラム（日本語タグ）	https://community.atlassian.com/t5/Jira-Software/ct-p/jira-software
Discord #forge-dev チャンネル	招待リンクは公式ブログに掲載【^5】
Slack ワークスペース「Atlassian Developers JP」	https://join.slack.com/t/atlassiandevjp/shared_invite/...

ポイント：forge logs と公式ドキュメントの併用でほとんどの障害は自己解決可能です。コミュニティは同様の課題を抱える開発者が集まるため、検索・質問が非常に有効です。

まとめ

Forge はサーバーレス化・自動スケール・標準認証という三本柱で、2026 年のクラウドネイティブ開発トレンドと合致しています。
開発環境は Atlassian アカウント取得 → Node.js/LTS インストール → Forge CLI 設置 → forge create の 4 手順で数分で完了します。
最小構成の Hello World プラグインは manifest.yml と src/index.js のみで動作し、UI Kit と Custom UI の使い分けが設計指針となります。
ローカルエミュレータと forge tunnel によるテスト、Git ベースの CI/CD パイプラインを組み合わせれば、安全かつ高速に本番デプロイできます。
実務ユースケース（自動フィールド生成・AI アシスタント連携など）と 2026 年版セキュリティ要件（最小スコープ、シークレット管理、Zero‑Trust）を合わせて実装すれば、信頼性の高いプラグインが完成します。
エラーは forge logs と公式ドキュメントで自己解決しつつ、コミュニティリソースを活用することで開発サイクルを最適化できます。

参考文献

[^1]: Gartner, 2025 Cloud Development Forecast, 2024年12月.
[^2]: Atlassian Roadmap (2025 Q3), https://developer.atlassian.com/platform/roadmap/.
[^3]: Atlassian Security Whitepaper, 2024年10月版.
[^4]: OpenAI API Usage Report for Enterprise, 2025年9月.
[^5]: Atlassian Forge Discord 招待リンク（公式ブログ掲載）: https://developer.atlassian.com/forge/discord.

スポンサードリンク

お得なお知らせ

スポンサードリンク

タイプ別にすぐ選べる

2026年、ビジネス競争力を上げる2ルート

"組織を動かす"立場と"個人スキルを伸ばす"立場では必要な打ち手が違います。自分の役割で選んでください。

▷ 部門・全社でAIリテラシー研修を入れたい管理職・人事・経営層

【Kindle本】イノベーションOps　組織を動かすDX&AI導入プロセスのすべて

▷ 個人のビジネススキル・思考法を"本から"底上げしたい実務担当者

Kindle Unlimited 30日無料｜ビジネス書読み放題▶

※積極的な自己学習が成長への近道です

▶ 耳で学ぶビジネススキルならオーディオブックAudible 。日経BP・東洋経済系の話題作も対象です。

-JIRA

comment コメントをキャンセル

: JIRA

Atlassian Intelligence と Jira AI の最新機能と活用事例

Atlassian Intelligence は生成AIをコアにしたJiraのAI支援機能で、エディタ支援や自動化が本格提供されています。

: JIRA

Jiraカスタムフィールドの設定ガイド: 権限確認から最適化まで

Jiraのカスタムフィールド設定には管理者権限確認、フィールドタイプ選定、スクリーン割り当てが不可欠です。Server版でのインデックス再構築やユーザー負荷軽減策も解説。

: JIRA

Jira AIエージェントでプロジェクト管理を自動化するベストプラクティス

Jira に搭載された AI エージェントがタスク自動割り当てやスプリント容量予測を行い、プロジェクト管理を効率化します。

: JIRA

Jiraテンプレート活用ガイド：Cloud vs Data Center と AI 提案

Jiraテンプレートの概要と活用目的から、Cloud と Data Center のフロー比較、AIエージェントによる提案機能、カスタマイズ性・ガバナンス・コストまでを網羅的に解説します。

: JIRA

Jira カスタムフィールド作成・画面割り当てとインデックス再構築完全ガイド

Jira 管理者が必要な権限確認からカスタムフィールドの作成・タイプ選択、スクリーン割り当て、Server のインデックス再構築までを実務で即活用できる手順にまとめました。

AirTriポイント制度の基本と活用術｜キャンペーン・交換ガイド

Google Nestカメラ2026モデル比較｜屋内外の特徴と選び方

Atlassian Forge入門と2026年開発トレンド完全ガイド

Atlassian Forge と 2026 年版開発トレンドの全体像

アーキテクチャ差異

2026 年版トレンドとの合致

開発環境の準備：アカウント作成から CLI 設置まで

アカウント取得

Node.js と npm のインストール

Forge CLI の導入と認証

プロジェクトの初期化

最小構成 Hello World プラグインの実装

必要ファイルと主要キー

manifest.yml の抜粋

index.js の抜粋

UI Kit と Custom UI の選び方

テストとデプロイ：ローカルシミュレーションから Jira Cloud へ

ローカルエミュレータでの検証

forge tunnel によるリアルタイムテスト

バージョン管理とリリースフロー

デプロイ手順

実務活用例と 2026 年版セキュリティ対策

ユースケース例

2026 年版セキュリティチェックリスト

トラブルシューティングと公式サポート・コミュニティリソース

よくあるエラーと対応策

デバッグフロー

公式・コミュニティリソース

まとめ

参考文献

`forge tunnel` によるリアルタイムテスト