컨테이너

​

Container

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)

• name (str | None) : DNS-1123 레이블입니다. 단일 컨테이너에서는 선택이며, 여러 컨테이너를 지정할 때는 Required입니다.
• command (str | None) : 진입점입니다. 빈 값/None이면 이미지 진입점을 사용합니다. command 없이도 인수를 설정할 수 있습니다.
• args (Sequence[str] | None) : command 또는 이미지 진입점에 전달할 인수입니다.
• environment_variables (Mapping[str, str] | None) : 이 컨테이너에만 주입되는 환경 변수입니다.
• resources (ResourceOptions | dict[str, Any] | None) : 이 컨테이너의 CPU/메모리/GPU입니다. 여러 컨테이너를 지정할 때는 Required입니다.
• 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) : command의 작업 디렉터리입니다. 설정 시 절대 경로여야 합니다.
• image_pull_credentials (ImagePullCredentials | Mapping[str, Any] | None) : 비공개 레지스트리에서 이미지를 가져오기 위한 자격 증명입니다.
• primary (bool) : True이면 이 컨테이너가 샌드박스 라이프사이클을 관리하며, 기본 exec/logs/files 대상이 됩니다. Default: False.

​

ContainerStatus

class ContainerStatus(*, name: str, state: SandboxStatus, exit_code: int | None = None, restart_count: int = 0)

• exit_code (int | None) : 컨테이너가 종료 상태에 도달한 후의 종료 코드. 컨테이너가 아직 실행 중인 동안에는 None입니다.
• restart_count (int) : 컨테이너가 재시작된 횟수. 기본값: 0.

​

SecurityContext

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)

• 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 capability(예: "SYS_PTRACE").
• capabilities_drop (Sequence[str] | None) : 삭제할 Linux capability.
• seccomp_profile (str | None) : "RuntimeDefault" 또는 "Unconfined".

​

ImagePullCredentials

class ImagePullCredentials(*, registry: str, store: str, name: str, field: str = '')

• field (str) : 선택 구조화된 시크릿 필드. Default: ''.