Semantic Releaseコンフィグビルダー
semantic-releaseの設定をビジュアルに構築。プラグイン選択、ブランチとリリースルールの設定を行い、お好みのフォーマットでエクスポートできます。
このツールについて
Semantic Releaseコンフィグビルダーは、JSONやYAMLを手書きする代わりにビジュアルインターフェースを通じて semantic-release 設定ファイルを作成する無料のブラウザベースツールです。ブランチの設定、プラグインの選択、 プラグイン固有のオプション設定、カスタムリリースルールの定義を1つのフォームから行えます。
このツールは、リリースタイプを決定する@semantic-release/commit-analyzer、
リリースノートを作成する@semantic-release/release-notes-generator、
CHANGELOG.mdを管理する@semantic-release/changelog、
npmレジストリへの公開を行う@semantic-release/npm、
GitHubリリースとissueコメントの@semantic-release/github、
成果物をリポジトリにコミットバックする@semantic-release/git、
リリースライフサイクル中にカスタムシェルコマンドを実行する@semantic-release/exec
を含む完全なsemantic-releaseプラグインエコシステムをサポートしています。
設定は.releaserc.json、.releaserc.yml、release.config.jsの3つの一般的な形式でエクスポートできます。
JSONとYAML間の変換が必要な場合は、JSON to YAMLコンバーターをご覧ください。
JSON設定ファイルのフォーマットには、JSONフォーマッターをお試しください。
すべての処理はブラウザ内で完全に実行されます。設定データ、プラグイン設定、 ブランチ名がサーバーに送信されることはありません。CI/CD設定はプライベートかつ安全に保たれます。
使い方
- リリースブランチを設定します。ブランチ名（例：main、next、beta）を追加し、デフォルト以外のブランチにはオプションのチャネルとプレリリースタグを設定します。
- 各プラグイン名の横にあるチェックボックスで必要なプラグインを有効にします。最も一般的なプラグイン（commit-analyzer、release-notes-generator、npm、github）はデフォルトで有効です。
- 有効な各プラグインを展開して、プリセット、Changelogファイルパス、npm公開設定、GitHubリリースアセットなどの固有のオプションを設定します。
- デフォルトのコミット→リリースマッピングを上書きするリリースルールを追加します。例えば、
docsコミットをpatchリリースにマッピングしたり、refactorをリリースなしにできます。 - 好みの出力フォーマット（.releaserc.json、.releaserc.yml、release.config.js）を選択します。
- 右側の出力パネルで生成された設定を確認します。
- CopyをクリックするかCtrl+Shift+Cを押して設定をクリップボードにコピーするか、Downloadをクリックしてファイルとして保存します。
人気のsemantic-release設定例
よくある質問
semantic-releaseとは何ですか？
semantic-releaseは、バージョン管理とパッケージ公開を完全に自動化するツールです。Conventional Commits仕様に従ったコミットメッセージに基づいて次のバージョン番号を決定し、リリースノートを生成し、パッケージを公開します。バージョニングプロセスから人間の意思決定を排除し、バージョン番号が行われた変更を正確に反映することを保証します。
どの出力フォーマットを使うべきですか？
3つのフォーマット（.releaserc.json、.releaserc.yml、release.config.js）はすべてsemantic-releaseで等しくサポートされています。プロジェクトが既にJSON設定を使用している場合は.releaserc.jsonを使用します。YAMLの読みやすさを好む場合は.releaserc.ymlを選択します。動的な設定やコメントの追加が必要な場合はrelease.config.jsを使用します。
プレリリースブランチとは何ですか？
プレリリースブランチ（beta、alpha、nextなど）を使用すると、パッケージのプレリリースバージョンを公開できます。例えば、prereleaseを「beta」に設定した「beta」ブランチへのコミットは、1.2.0-beta.1のようなバージョンを作成します。
リリースルールはどのように機能しますか？
リリースルールは、コミットタイプとリリースタイプ間のデフォルトマッピングを上書きします。デフォルトでは、「feat」コミットはマイナーリリース、「fix」コミットはパッチリリースをトリガーします。ルールを追加して、例えば「perf」コミットでマイナーリリースをトリガーしたり、「docs」コミットでリリースなしにすることができます。
すべてのプラグインが必要ですか？
いいえ。必須のプラグインは@semantic-release/commit-analyzerのみです。ただし、ほとんどのプロジェクトではcommit-analyzer、release-notes-generator、npmまたはgithubの少なくとも3つを使用します。changelogとgitプラグインはオプションですが、CHANGELOG.mdの管理やリリース成果物のコミットバックに人気があります。
データは安全ですか？
はい。すべての設定生成はJavaScriptを使用してブラウザ内で完全に実行されます。ブランチ名、プラグイン設定、設定値などのデータがサーバーに送信されることはありません。ツール使用中にブラウザの開発者ツールのネットワークタブで確認できます。
モノレポ設定に使用できますか？
はい。モノレポでは、通常パッケージごとに個別のsemantic-release設定が必要です。@semantic-release/npmプラグインのpkgRootオプションを各パッケージのディレクトリに設定します。@semantic-release/execを使用して、公開前にカスタムビルドスクリプトを実行することもできます。
関連ツール
Changelogジェネレーター
Conventional CommitsからCHANGELOG.mdを生成します。タイプ別グループ化、バージョンヘッダー、Keep a Changelog形式でエクスポート。
Conventional Commitsリンター
コミットメッセージをConventional Commits仕様に照らして検証します。type、scope、description、bodyのフォーマットをチェック。
JSONフォーマッター
JSONの整形、検証、ツリー表示をシンタックスハイライト付きで行えます。
YAMLフォーマッター
カスタマイズ可能なインデントと構文エラー表示でYAMLの整形、検証、圧縮を行います。
JSON ↔ YAML変換
JSONとYAML形式をバリデーション付きで即座に変換します。
Docker Runコマンドビルダー
ポート、ボリューム、環境変数を視覚的に設定してdocker runコマンドとdocker-compose.ymlを生成します。
GitHub Actionsワークフロービルダー
GitHub ActionsワークフローYAMLファイルをビジュアルに構築します。トリガー、ジョブ、ステップ、マトリックス戦略、シークレット参照を設定。
フィーチャーフラグ設定ジェネレーター
LaunchDarkly、Unleash、JSON、YAML向けのフィーチャーフラグ設定テンプレートを生成します。ターゲティングルールとロールアウト対応。
リリースノートジェネレーター
バージョン情報と変更エントリからプロフェッショナルなリリースノートを生成します。
Semverカリキュレーター
Semver範囲マッチの確認、バージョン比較、インクリメント計算、バージョンリストの一括テスト。