メインコンテンツまでスキップ

Python

Semaphore は Python スクリプトを直接実行できます。そのためには、Python タスクテンプレートを作成します。

Python テンプレートの作成​

  1. タスクテンプレートセクションに移動し、新しいテンプレートボタンをクリックします。
  2. アプリの種類として Python を選択します。
  3. テンプレートを設定します:
フィールド説明
名前テンプレートのわかりやすい名前
リポジトリ.py スクリプトを含むリポジトリ
Playbook / スクリプトスクリプトへの相対パス (例: scripts/deploy.py)
変数グループ値が環境変数として注入される変数グループ
  1. 作成をクリックします。
  2. 実行をクリックしてテンプレートを実行します。

スクリプトへの変数の受け渡し​

選択した変数グループの変数は、環境変数として注入されます。Python 内では os.environ でアクセスします。

import os

target = os.environ.get("TARGET_HOST")
print(f"Deploying to {target}")

Python のバージョンと依存関係​

Semaphore は、実行環境の PATH 上にある python3 バイナリをそのまま使用します。

  • バイナリ/パッケージによるインストール: ホストに正しい python3 がインストールされていることを確認してください。
  • Docker: 必要な Python バージョンを含むカスタムイメージを使用してください。
  • Docker (追加パッケージ): サーバーまたは runner のコンテナ内の /etc/semaphore/requirements.txt に requirements.txt をマウントします。Semaphore はコンテナの起動ごとに、同梱の Python 仮想環境にそれをインストールします。追加の Python 依存関係のインストールを参照してください。

注意事項​

  • スクリプトは非対話的に実行されます。
  • 終了コード 0 は成功を意味し、0 以外の終了コードはタスクを失敗としてマークします。