--- title: 컨테이너를 위한 커맨드와 인자 정의하기 content_type: task weight: 10 --- 본 페이지는 {{< glossary_tooltip text="파드" term_id="pod" >}} 안에서 컨테이너를 실행할 때 커맨드와 인자를 정의하는 방법에 대해 설명한다. ## {{% heading "prerequisites" %}} {{< include "task-tutorial-prereqs.md" >}} {{< version-check >}} ## 파드를 생성할 때 커맨드와 인자를 정의하기 파드를 생성할 때, 파드 안에서 동작하는 컨테이너를 위한 커맨드와 인자를 정의할 수 있다. 커맨드를 정의하기 위해서는, 파드 안에서 실행되는 컨테이너에 `command` 필드를 포함시킨다. 커맨드에 대한 인자를 정의하기 위해서는, 구성 파일에 `args` 필드를 포함시킨다. 정의한 커맨드와 인자들은 파드가 생성되고 난 이후에는 변경될 수 없다. 구성 파일 안에서 정의하는 커맨드와 인자들은 컨테이너 이미지가 제공하는 기본 커맨드와 인자들보다 우선시 된다. 만약 인자들을 정의하고 커맨드를 정의하지 않는다면, 기본 커맨드가 새로운 인자와 함께 사용된다. {{< note >}} `command` 필드는 일부 컨테이너 런타임에서 `entrypoint`에 해당된다. 아래의 [참고사항](#참고사항)을 확인하자. {{< /note >}} 이 예제에서는 한 개의 컨테이너를 실행하는 파드를 생성한다. 파드를 위한 구성 파일에서 커맨드와 두 개의 인자를 정의한다. {{< codenew file="pods/commands.yaml" >}} 1. YAML 구성 파일을 활용해 파드를 생성한다. ```shell kubectl apply -f https://k8s.io/examples/pods/commands.yaml ``` 1. 실행 중인 파드들의 목록을 조회한다. ```shell kubectl get pods ``` 출력은 command-demo라는 파드 안에서 실행된 컨테이너가 완료되었다고 표시할 것이다. 1. 컨테이너 안에서 실행된 커맨드의 출력을 보기 위해, 파드의 로그를 확인한다. ```shell kubectl logs command-demo ``` 출력은 HOSTNAME과 KUBERNETES_PORT 환경 변수들의 값들을 표시할 것이다. ``` command-demo tcp://10.3.240.1:443 ``` ## 인자를 정의하기 위해 환경 변수를 사용하기 이전 예제에서는, 문자열을 제공하면서 직접 인자를 정의해보았다. 문자열을 직접 제공하는 것에 대한 대안으로, 환경 변수들을 사용하여 인자들을 정의할 수 있다. ```yaml env: - name: MESSAGE value: "hello world" command: ["/bin/echo"] args: ["$(MESSAGE)"] ``` 이것은 [컨피그 맵](/docs/tasks/configure-pod-container/configure-pod-configmap/)과 [시크릿](/ko/docs/concepts/configuration/secret/)을 포함해, 환경 변수를 정의하는데 활용할 수 있는 모든 방법들을 활용해서 파드를 위한 인자를 정의할 수 있다는 것을 의미한다. {{< note >}} 환경 변수는 `"$(VAR)"`와 같이 괄호 안에 나타난다. 이는 변수가 `command`나 `args` 필드 안에서 전개되기 위해 필요한 것이다. {{< /note >}} ## 셸 안에서 커맨드 실행하기 일부 경우들에서는 커맨드를 셸 안에서 실행해야할 필요가 있다. 예를 들어, 실행할 커맨드가 서로 연결되어 있는 여러 개의 커맨드들로 구성되어 있거나, 셸 스크립트일 수도 있다. 셸 안에서 커맨드를 실행하려고 한다면, 이런 방식으로 감싸주면 된다. ```shell command: ["/bin/sh"] args: ["-c", "while true; do echo hello; sleep 10;done"] ``` ## 참고사항 이 테이블은 도커와 쿠버네티스에서 사용되는 필드 이름들을 정리한 것이다. | 설명 | 도커 필드 이름 | 쿠버네티스 필드 이름 | |----------------------------------------|------------------------|-----------------------| | 컨테이너에서 실행되는 커맨드 | Entrypoint | command | | 커맨드에 전달되는 인자들 | Cmd | arg | 기본 Entrypoint와 Cmd 값을 덮어쓰려고 한다면, 아래의 규칙들이 적용된다. * 만약 컨테이너를 위한 `command` 값이나 `args` 값을 제공하지 않는다면, 도커 이미지 안에 제공되는 기본 값들이 사용된다. * 만약 컨테이너를 위한 `command` 값을 제공하고, `args` 값을 제공하지 않는다면, 제공된 `command` 값만이 사용된다. 도커 이미지 안에 정의된 기본 EntryPoint 값과 기본 Cmd 값은 덮어쓰여진다. * 만약 컨테이너를 위한 `args` 값만 제공한다면, 도커 이미지 안에 정의된 기본 EntryPoint 값이 정의한 `args` 값들과 함께 실행된다. * `command` 값과 `args` 값을 동시에 정의한다면, 도커 이미지 안에 정의된 기본 EntryPoint 값과 기본 Cmd 값이 덮어쓰여진다. `command`가 `args` 값과 함께 실행된다. 여기 몇 가지 예시들이 있다. | 이미지 Entrypoint | 이미지 Cmd | 컨테이너 command | 컨테이너 args | 실행되는 커맨드 | |--------------------|------------------|---------------------|--------------------|------------------| | `[/ep-1]` | `[foo bar]` | <설정되지 않음> | <설정되지 않음> | `[ep-1 foo bar]` | | `[/ep-1]` | `[foo bar]` | `[/ep-2]` | <설정되지 않음> | `[ep-2]` | | `[/ep-1]` | `[foo bar]` | <설정되지 않음> | `[zoo boo]` | `[ep-1 zoo boo]` | | `[/ep-1]` | `[foo bar]` | `[/ep-2]` | `[zoo boo]` | `[ep-2 zoo boo]` | ## {{% heading "whatsnext" %}} * [파드와 컨테이너를 구성하는 방법](/ko/docs/tasks/)에 대해 더 알아본다. * [컨테이너 안에서 커맨드를 실행하는 방법](/ko/docs/tasks/debug-application-cluster/get-shell-running-container/)에 대해 더 알아본다. * [컨테이너](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/#container-v1-core)를 확인한다.