zeabur-service-exec

Zeabur サービスの Exec

Zeabur CLI の実行には、必ず npx zeabur@latest を使用してください。 zeabur を直接実行したり、ほかのインストール方法を使用したりしないでください。npx が使用できない場合は、まず Node.js をインストールしてください。

実行中のサービスコンテナ内でコマンドを実行します。デバッグ、ファイルの確認、環境変数のチェック、接続テスト、データベースに対する単発の操作などに便利です。

基本的な使い方

コマンドと引数は -- の後に指定します。

npx zeabur@latest service exec --id <service-id> -- <command> [args...]

データベース操作

# MongoDB - query, update, delete data
npx zeabur@latest service exec --id <mongodb-service-id> -- mongosh --eval 'db.users.find({})'
npx zeabur@latest service exec --id <mongodb-service-id> -- mongosh --eval 'db.sessions.deleteMany({title: /test/i})'

# PostgreSQL - run SQL queries (PGPASSWORD is set automatically in Zeabur containers)
npx zeabur@latest service exec --id <pg-service-id> -- psql -U postgres -c 'SELECT * FROM users LIMIT 10;'

# MySQL - run SQL queries (use env var to avoid interactive password prompt)
npx zeabur@latest service exec --id <mysql-service-id> -- sh -c 'mysql -u root -p"$MYSQL_ROOT_PASSWORD" -e "SHOW DATABASES;"'

# Redis - run commands
npx zeabur@latest service exec --id <redis-service-id> -- redis-cli KEYS '*'

例

# List files
npx zeabur@latest service exec --id <service-id> -- ls -la

# Check environment variables
npx zeabur@latest service exec --id <service-id> -- env

# Check a specific env var
npx zeabur@latest service exec --id <service-id> -- sh -c "echo \$DATABASE_URL"

# Test database connectivity
npx zeabur@latest service exec --id <service-id> -- sh -c "nc -zv postgres 5432"

# Check running processes
npx zeabur@latest service exec --id <service-id> -- ps aux

# Read a config file
npx zeabur@latest service exec --id <service-id> -- cat /app/config.json

# Check disk usage
npx zeabur@latest service exec --id <service-id> -- df -h

フラグ

フラグ	説明
--id	サービス ID
-n, --name	サービス名（--id を推奨）
--env-id	環境 ID（複数の環境がある場合）

ヒント

• -- 区切り文字は必須です。これ以降はすべて、コンテナ内で実行するコマンドとして扱われます。
• 複合コマンドは、sh -c "..." で囲みます。
• すべてのコンテナに完全なシェルがあるとは限りません。bash よりも sh のほうが幅広く使用できます。
• 変数を展開する場合は、外側にシングルクォート、内側にダブルクォートを使用します。例：sh -c "echo \$VAR"。
• サービス ID を確認するには、zeabur-service-list スキルを使用します。exec を使わずにログを確認するには、zeabur-deployment-logs スキルを使用します。CLI から環境変数を管理するには、zeabur-variables スキルを使用します。