管理者ガイド
このセクションは、他の人のために Semaphore をインストールして運用する管理者向けです。 ここにある作業はすべて、サーバー自体へのアクセスを必要とします。設定ファイル、 環境変数、コマンドライン、または Semaphore が動作して いるマシンです。Web インター フェースを通じてプロジェクト内で行う作業は、ユーザーガイドで説明しています。
Semaphore は、Web インターフェースと REST API を備えた単一の Go バイナリです。データは SQLite、MySQL、または PostgreSQL に保存し、認証情報は暗号化して保持し、タスクはサーバー 自体か、別のランナーで実行します。したがって、動作するインストールは 4 つの判断に 集約されます。どのようにインストールするか、データベースをどこに置くか、ユーザーが どのようにサインインするか、そしてタスクをどこで実行するかです。
セットアップ
サーバーを起動する前後に設定するすべての事項です。
| ページ | 内容 |
|---|---|
| インストール | パッケージマネージャー、Docker、バイナリ、Kubernetes、および手動セットアップです。 |
| 設定 | config.json ファイル、環境変数、およびサポートされるすべてのオプションです。 |
| アップグレード | 新しいリリースへの移行と、最初に確認すべき点です。 |
| リバースプロキシ | nginx、Apache、または Caddy の背後で、TLS を使って Semaphore を公開します。 |
| セキュリティ | パスワードのハッシュ 化、シークレットの暗号化、ネットワークの強化、タスクの JWT です。 |
| 認証 | ローカルアカウントと二要素認証、LDAP と Active Directory、そして 12 種類の OpenID Connect プロバイダーによるシングルサインオン。 |
| ランナー | サーバー以外のマシンでタスクを実行します。 |
| 高可用性 | 1 つのデータベースに対して複数の Semaphore ノードを実行します。 |
運用
すでに稼働しているサーバー上で行うすべての作業です。
| ページ | 内容 |
|---|---|
| CLI | シェルからユーザー、プロジェクト、vault、ランナー、データベースマイグレーションを管理します。 |
| API | トークンによる認証と、プログラムからの Semaphore の操作です。 |
| CI/CD 連携 | 外部のパイプラインから Semaphore のタスクを開始します。 |
| ログ | サーバーログ、タスクログ、およびそれらの外部への転送です。 |
| メトリクス | Prometheus のエンドポイントと、そこで公開されるメトリクスです。 |
| 通知 | アラートの配信チャンネルです。メール、Telegram、Slack などがあり ます。 |
| ライセンス | Pro または Enterprise のサブスクリプションを有効化します。 |
ここから始める
Semaphore を初めてインストールする場合は、インストールを 読んで方法を 1 つ選び、次に設定でオプションの指定方法を 学んでください。他の人が使い始める前に、TLS を設定した リバースプロキシの背後にサーバーを配置してください。
有償サブスクリプションで何が追加されるかは、エディションを参照してください。