ユーザーガイド

このセクションは、すでに Semaphore のプロジェクトへのアクセス権を持っている人向けです。 ここにある作業はすべて、Web インターフェースまたはプロジェクトの API で行います。サーバー のインストール、その設定、ID プロバイダーとの接続については、 管理者ガイドで説明しています。

Semaphore での作業は 1 本の流れに沿って進みます。プロジェクト が他のすべてを保持します。 その中に、実行に必要なリソースを登録します。playbook やスクリプトを含む リポジトリ、 リポジトリやホストへの接続に使う キー、対象マシンの インベントリ、そして値とシークレット を持つ 変数グループ です。タスクテンプレート はこれらを組み合わせて実行内容を定義し、 そのテンプレートの 1 回ごとの実行が タスク になります。スケジュール、ワークフロー、受信 Webhook は、テンプレートを自動的に開始します。

プロジェクトのセットアップ

各ステップは前のステップに依存するため、この順序で進めてください。

ページ	内容
プロジェクト	プロジェクトの作成、サイドバーの各セクション、バックアップと復元です。
チーム	4 つの組み込みロールと、Enterprise のカスタムロールです。
キーストア	SSH キー、ログイン情報、外部のシークレットストレージです。
リポジトリ	自動化のコードを保持する Git リポジトリとローカルパスです。
インベントリ	Ansible 向けのホストと接続設定、Terraform 向けのワークスペースです。
変数グループ	タスクに渡される再利用可能な変数とシークレットです。

作業の定義と実行

ページ	内容
タスクテンプレート	テンプレートフォームのすべてのフィールドと、テンプレートの種類です。
アプリ	各アプリケーションが実行するものです。Ansible、Terraform、OpenTofu、Terragrunt、スクリプトがあります。
タスク	タスクの開始、タスクのステータス、ログ、停止、再実行です。
スケジュール	cron スケジュールでテンプレートを実行します。
ワークフロー	承認と分岐を伴うテンプレートの連結です。
インテグレーション	受信 Webhook からタスクを開始します。
プロジェクトのランナー	プロジェクトのタスクを自分のランナーに送ります。
アカウント	個人設定と API トークンです。

ここから始める

プロジェクトに追加されたばかりなら、まずプロジェクトを読んで 全体像をつかみ、次にタスクでタスクを実行してログを読んでください。 プロジェクトをゼロからセットアップする場合は、上の表の順に進めてください。

Semaphore 自体が初めてですか？ はじめにから始めてください。