> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# コンテナー

> コンテナーの定義、観測されたコンテナーの状態、およびコンテナーごとの権限。

<h2 id="container">
  Container
</h2>

ソース: [src/cwsandbox/\_types.py:1181](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L1181)

```python theme={"system"}
class Container(*, image: str, name: str | None = None, command: str | None = None, args: Sequence[str] | None = None, environment_variables: Mapping[str, str] | None = None, resources: ResourceOptions | dict[str, Any] | None = None, mounted_files: Sequence[Mapping[str, Any]] | None = None, volume_mounts: Sequence[VolumeMount | Mapping[str, Any]] | None = None, secrets: Sequence[Secret | Mapping[str, Any]] | None = None, working_dir: str | None = None, image_pull_credentials: ImagePullCredentials | Mapping[str, Any] | None = None, primary: bool = False)
```

サンドボックス内の 1 つのユーザーコンテナーです。

`Sandbox.run(containers=[...])` にリストを渡します。この形式は、単一コンテナー用の
キーワード引数 (`container_image`、
`command`/`args`、`resources`、`mounted_files`、`secrets`、
`image_pull_credentials`、`environment_variables`、
`security_context`、`working_dir`) と同時には使用できず、
`SandboxDefaults` からこれらのフィールドを継承しません。

コンテナーが 1 つの場合: `primary` は省略するか False にできます (その行がプライマリになります)。
複数の場合: ちょうど 1 つの行で `primary=True` を設定する必要があり、すべての行に
名前とリソースが必要です。GPU はプライマリでのみ使用できます。

**属性**

* `name` (`str | None`) : DNS-1123 ラベル。コンテナーが 1 つの場合はオプションで、
  複数のコンテナーを指定する場合は必須です。
* `command` (`str | None`) : エントリポイント。空または None の場合はイメージのエントリポイントを使用します。command を指定せずに
  args を設定することもできます。
* `args` (`Sequence[str] | None`) : コマンドまたはイメージのエントリポイントに渡す引数。
* `environment_variables` (`Mapping[str, str] | None`) : このコンテナーにのみ注入される環境変数。
* `resources` (`ResourceOptions | dict[str, Any] | None`) : このコンテナーの CPU/メモリ/GPU。複数のコンテナーを
  指定する場合は必須です。
* `mounted_files` (`Sequence[Mapping[str, Any]] | None`) : 起動時にこのコンテナーに書き込まれるファイル。
* `volume_mounts` (`Sequence[VolumeMount | Mapping[str, Any]] | None`) : このコンテナーにマウントするサンドボックスレベルのボリューム。
* `secrets` (`Sequence[Secret | Mapping[str, Any]] | None`) : このコンテナーにのみ注入するシークレットストアのシークレット。
* `working_dir` (`str | None`) : コマンドの作業ディレクトリ。設定する場合は
  絶対パスである必要があります。
* `image_pull_credentials` (`ImagePullCredentials | Mapping[str, Any] | None`) : プライベートレジストリからプルするための認証情報。
* `primary` (`bool`) : True の場合、このコンテナーがサンドボックスのライフサイクルを管理し、
  exec/logs/files のデフォルトの対象になります。デフォルト: `False`。

***

<h2 id="containerstatus">
  ContainerStatus
</h2>

ソース: [src/cwsandbox/\_sandbox.py:335](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_sandbox.py#L335)

```python theme={"system"}
class ContainerStatus(*, name: str, state: SandboxStatus, exit_code: int | None = None, restart_count: int = 0)
```

サンドボックス上の 1 つのコンテナーについて観測された状態です。

サンドボックスの `status` / `returncode` は、引き続きプライマリコンテナーが管理します。この行は、
その名前のコンテナーを kubelet から見た状態です。

**属性**

* `exit_code` (`int | None`) : コンテナーが終端状態になった時点の終了コード。
  コンテナーの実行中は None です。
* `restart_count` (`int`) : コンテナーが再起動した回数。デフォルト: `0`。

***

<h2 id="securitycontext">
  SecurityContext
</h2>

ソース: [src/cwsandbox/\_types.py:993](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L993)

```python theme={"system"}
class SecurityContext(*, run_as_user: int | None = None, run_as_group: int | None = None, privileged: bool | None = None, allow_privilege_escalation: bool | None = None, read_only_root_filesystem: bool | None = None, capabilities_add: Sequence[str] | None = None, capabilities_drop: Sequence[str] | None = None, seccomp_profile: str | None = None)
```

ゲスト内のコンテナー権限です。ランナーのポリシーによって制限されます。

ホストに到達する設定 (host network、host PID、hostPath) はここでは
指定できません。`privileged`、capabilities、run-as、seccomp は
サンドボックスの分離境界の内側で適用されます。

**属性**

* `run_as_user` (`int | None`) : エントリポイントの UID。未設定の場合はイメージのユーザーを使用します。
* `run_as_group` (`int | None`) : エントリポイントの GID。未設定の場合はイメージのグループを使用します。
* `privileged` (`bool | None`) : 分離境界の内側で特権モードで実行します。
* `allow_privilege_escalation` (`bool | None`) : プロセスが親プロセスよりも多くの権限を
  取得することを許可します。
* `read_only_root_filesystem` (`bool | None`) : コンテナーのルートファイルシステムを読み取り専用でマウントします。
* `capabilities_add` (`Sequence[str] | None`) : 追加する Linux capabilities (例: `"SYS_PTRACE"`)。
* `capabilities_drop` (`Sequence[str] | None`) : 削除する Linux capabilities。
* `seccomp_profile` (`str | None`) : `"RuntimeDefault"` または `"Unconfined"`。

***

<h2 id="imagepullcredentials">
  ImagePullCredentials
</h2>

ソース: [src/cwsandbox/\_types.py:912](https://github.com/coreweave/cwsandbox-client/blob/v1.14.2/src/cwsandbox/_types.py#L912)

```python theme={"system"}
class ImagePullCredentials(*, registry: str, store: str, name: str, field: str = '')
```

シークレットストアから解決される、プライベートレジストリのプル用認証情報です。

**属性**

* `field` (`str`) : 構造化シークレットのフィールド (オプション)。デフォルト: `''`。

***