プロジェクト
プロジェクトは、Semaphore UI における分離の主要な単位です。扱うすべてのリソース(タスクテンプレート、タスク、インベントリ、変数グループ、キー、リポジトリ、インテグレーション、スケジュール、ランナー、チームメンバー)は、必ず 1 つのプロジェクトに属します。
プロジェクトは互いに独立しているため、1 つの Semaphore インストール内で無関係なシステム(異な るチーム、インフラ、環境、アプリケーションなど)を整理するのに使用できます。
プロジェクトのナビゲーション
プロジェクトを開くと、左のサイドバーの上部にプロジェクトの切り替え、その下にプロジェクトのすべてのセクションが表示されます。プロジェクト名の下には、このプロジェクトでの自分のロール(たとえば task_runner)が表示されます。ロールによって変更できるセクションが決まります。チームを参照してください。

| セクション | 含まれる内容 |
|---|---|
| ダッシュボード | 履歴、統計、アクティビティ の各タブと、プロジェクトのオーナー向けの設定 |
| タスクテンプレート | 何をどのように実行するかの定義: タスクテンプレート |
| ワークフロー (Pro) | 承認と分岐を含むテンプレートのグラフ: ワークフロー |
| スケジュール | テンプレートの cron 形式のスケジュール: スケジュール |
| インベントリ | Ansible 用のホストと接続設定、Terraform 用のワークスペース: インベントリ |
| 変数グループ | タスクに注入される再利用可能な変数とシークレット: 変数グループ |
| キーストア | 暗号化された認証情報と外部のシークレットストレージ: キーストア |
| リポジトリ | playbook やスクリプトを含む Git リポジトリまたはローカルパス: リポジトリ |
| インテグレーション | タスクを開始する受信 Webhook: インテグレーション |
| チーム | メンバーとそのロール: チーム |
| ランナー (Pro) | このプロジェクトに接続されたランナー: プロジェクトのランナー |
サイドバーの下部には、ダークモードの切り替え、言語の切り替え、アカウントメニューがあります。
プロジェクトの作成
プロジェクトの作成は管理者が行えます。一 般ユーザーは、サーバーのオプション non_admin_can_create_project(SEMAPHORE_NON_ADMIN_CAN_CREATE_PROJECT)が有効な場合にのみプロジェクトを作成できます。設定を参照してください。
- サイドバー上部のプロジェクト名をクリックし、新しいプロジェクト を選択します。
- フォームに入力します。
| フィールド | 説明 |
|---|---|
| プロジェクト名 | プロジェクトの表示名です。後から設定で変更できます。 |
| 並列タスクの最大数 | 任意です。このプロジェクトのタスクを同時にいくつ実行できるかを指定します。制限しない場合は空のままにします。制限を超えたタスクは waiting のステータスでキューに待機します。 |
| デモ | 新しいプロジェクトにサンプルデータ(公開デモリポジトリ、インベントリ、キー、いくつかのタスクテンプレート)を登録します。何も設定せずに Semaphore を試したいときに使用します。 |
- 作成 をクリックします。
プロジェクトを作成したユーザーは、そのプロジェクトの オーナー になります。
プロジェクトの切り替え
サイドバー上部のプロジェクト名をクリックすると、自分 がメンバーになっているすべてのプロジェクトが表示され、切り替えられます。最後に開いたプロジェクトはブラウザーに記憶されます。
バックアップと復元
プロジェクトは JSON ファイルにエクスポートし、同じ Semaphore インスタンスまたは別のインスタンスにインポートできます。
- エクスポート: ダッシュボード → 設定 を開き、プロジェクトのバックアップ をクリックします(設定を参照)。
- インポート: サイドバーのプロジェクト名をクリックし、プロジェクトの復元 を選択して、バックアップファイルをアップロードします。
どちらの操作もコマンドラインからも実行できます。CLI: プロジェクトを参照してください。