Interactive shells and TTY

これらの例では、CWSANDBOX_API_KEY に設定した CoreWeave API アクセストークンを使用します。Forge の APIキーによる認証については、はじめにを参照してください。CKS の要件については、配置モードを参照してください。インタラクティブな TTY セッションには Sandbox.shell() を使用します。生バイトのストリーミングに対応し、出力のバッファリングを行わない TerminalSession を返します。対話的な使用向けに設計されています。バッチでコマンドを実行する場合は、代わりに exec() を使用します。

シェルセッション

サンドボックスを作成し、インタラクティブシェルのセッションを開きます。引数なしで Sandbox.run() を呼び出すと、デフォルトの長時間実行コマンドが使用されます。以降のサンプルは、このコンテキストが引き続き実行中であることを前提としています。

from cwsandbox import Sandbox

with Sandbox.run() as sandbox:
    terminal = sandbox.shell(
        ["/bin/bash"],
        width=80,
        height=24,
    )

shell() は常に TTY を割り当て、stdin を有効にします。返される TerminalSession は、UTF-8 のデコードやエンコードの往復なしに生のバイトをストリーミングするため、ターミナルのエスケープシーケンスやバイナリ出力に対して安全です。

コマンドを送信して出力を読み取る

ターミナルセッションを開いた状態で、stdin にコマンドを書き込み、リモートシェルからマージされたバイト出力をストリームで返します。

import sys

terminal.stdin.writeline("echo hello").result()
terminal.stdin.writeline("ls -la /tmp").result()
terminal.stdin.writeline("exit").result()

# 生のバイト出力を反復処理します
for chunk in terminal.output:
    sys.stdout.buffer.write(chunk)
    sys.stdout.buffer.flush()  # セッションの実行中に出力が表示されるようにフラッシュします。

# 終了コードを取得します
exit_code = terminal.wait(timeout=5.0)

TerminalSession は出力をバッファしません。stdout と stderr は、terminal.output 上の単一の生バイトストリームにマージされます。結果に個別の stdout 属性や stderr 属性はありません。terminal.output は継続的に読み取ってください。読み取りを止めると、上限付きキューのバックプレッシャーによってリモートセッションが停止します。

ターミナルのサイズ変更

ターミナルのサイズが変わったときに、サイズ変更メッセージを送信します。

terminal.resize(120, 40)

resize() は TerminalSession でファイア・アンド・フォーゲットです。

シェルセッションの終了

stdin を閉じるか、終了コマンドを送信して、シェルセッションを終了します。

terminal.stdin.writeline("exit").result()  # リモートシェルに終了を要求します
# または
terminal.stdin.close().result()            # stdin ストリームを閉じます

リモートプロセスが終了すると、シェルセッションが完了します。terminal.wait() または terminal.result() を呼び出して、終了コードが返されるまでブロックします。

コマンドと使用例

使用例	方法
ターミナルから単発のコマンドを実行	`cwsandbox exec [ID] echo hello`
ターミナルからインタラクティブシェルを使用	`cwsandbox sh [ID]`
スクリプトを実行し、出力を取得 (SDK)	`exec(["python", "script.py"])`
インタラクティブシェルのセッション (SDK)	`shell(["/bin/bash"])`
コマンドに入力を送信 (SDK)	`exec(["cat"], stdin=True)`
ターミナルアプリケーション (vim、htop)	`shell(["vim"])` + CLI の raw モード

サンドボックス

サンドボックスを使用する

サンドボックスの管理

リファレンス

Interactive shells and TTY

シェルセッション

コマンドを送信して出力を読み取る

ターミナルのサイズ変更

シェルセッションの終了

コマンドと使用例

関連項目

​シェルセッション

​コマンドを送信して出力を読み取る

​ターミナルのサイズ変更

​シェルセッションの終了

​コマンドと使用例

​関連項目

シェルセッション

コマンドを送信して出力を読み取る

ターミナルのサイズ変更

シェルセッションの終了

コマンドと使用例

関連項目