はじめに

このページでは、新規インストールから最初のタスクの成功までを順を追って説明します。各ステップは詳細ページへのリンクになっています。

ゼロから最初のタスクまで

1. お好みの方法で Semaphore をインストールします: インストール。
2. セットアップ時に作成した管理者ユーザー、または Docker の場合は SEMAPHORE_ADMIN_* 変数でログインします。
3. プロジェクトを作成します。 プロジェクトはチーム、インフラ、アプリケーションを互いに分離します: プロジェクト。
4. 自動化に必要なものを接続します:
   • playbook、モジュール、スクリプトを含むソースコード: リポジトリ。
   • SSH キー、トークン、パスワード: キーストア。
   • 対象ホストと接続設定: インベントリ。
   • 再利用可能な変数: 変数グループ。
5. タスクテンプレートを作成して実行します。 お使いのツールのガイドを選択してください: Ansible、Terraform/OpenTofu、Shell、PowerShell、または Python。その後、実行して結果を確認します: タスク。
6. 自動化と運用化:
   • スケジュールで実行する: スケジュール。
   • 誰が何をできるかを制御する: チームとカスタムロール。
   • 結果の通知を受け取る: 通知。

主要な概念

これらの用語は UI のあらゆる場所に登場します。

用語	意味
プロジェクト	分離の基本単位。各プロジェクトは独自のリポジトリ、キー、インベントリ、テンプレート、チームを持ちます。プロジェクト
リポジトリ	playbook、モジュール、スクリプトが置かれている Git リポジトリまたはローカルパス。リポジトリ
インベントリ	Ansible スタイルの実行のためのホスト、グループ、接続設定。インベントリ
変数グループ	再利用可能な変数と環境設定。Environment とも呼ばれます。変数グループ
キーストア	SSH キー、トークン、パスワードなどの暗号化された認証情報。キーストア
タスクテンプレート	実行の定義: アプリ、リポジトリ、インベントリ、変数、オプション。タスクテンプレート
タスク	テンプレートの 1 回の実行。ログとステータスを持ちます。タスク
ワークフロー	分岐、承認、遅延を含むテンプレートのグラフ。Pro 機能。ワークフロー
Runner	タスクが実行される場所: サーバー自体またはリモートの runner。Runner

次のステップ

• リバースプロキシを使って Semaphore を TLS の背後に配置する。
• ID プロバイダーを接続する: LDAP または OpenID Connect。
• API と CLI を使って、CI やスクリプトから Semaphore を操作する。