스테이트리스(Stateless) Linux 애플리케이션 배포

Autopilot Standard

이 페이지에서는 Google Kubernetes Engine(GKE)을 사용하여 스테이트리스(Stateless) Linux 애플리케이션을 배포하는 방법을 설명합니다. 스테이트리스(Stateless) Windows 애플리케이션을 배포하는 방법도 설명합니다.

개요

스테이트리스(Stateless) 애플리케이션은 클러스터 또는 영구 스토리지에 데이터 또는 애플리케이션 상태를 저장하지 않는 애플리케이션입니다. 대신 데이터 및 애플리케이션 상태가 클라이언트에 유지되므로, 상태 비추적 애플리케이션은 확장성이 더 뛰어납니다. 예를 들어 프런트엔드 애플리케이션은 상태 비추적입니다. 여러 복제본을 배포하여 확장성을 높이고, 수요가 낮을 때 규모를 축소하고, 복제본에 고유 ID가 필요하지 않습니다.

Kubernetes는 배포 컨트롤러를 사용하여 스테이트리스(Stateless) 애플리케이션을 단일의 비고유 포드로 배포합니다. 배포는 애플리케이션을 실행할 포드 수, 실행할 컨테이너 이미지 버전, 라벨을 지정할 포드 등 애플리케이션의 원하는 상태를 관리합니다. 배포의 포드 사양을 업데이트하여 원하는 상태를 동적으로 변경할 수 있습니다.

스테이트리스(Stateless) 애플리케이션은 영구 스토리지를 사용하여 데이터를 저장하고, StatefulSets를 사용하여 포드에 고유 ID를 배포하는 StatefulSets과 대조됩니다.

시작하기 전에

시작하기 전에 다음 태스크를 수행했는지 확인합니다.

Google Kubernetes Engine API를 사용 설정합니다.

Google Kubernetes Engine API 사용 설정

이 태스크에 Google Cloud CLI를 사용하려면 gcloud CLI를 설치한 후 초기화합니다. 이전에 gcloud CLI를 설치한 경우 gcloud components update를 실행하여 최신 버전을 가져옵니다.
참고: 기존 gcloud CLI 설치의 경우 compute/region 및 compute/zone 속성을 설정해야 합니다. 기본 위치를 설정하면 gcloud CLI에서 One of [--zone, --region] must be supplied: Please specify location과 같은 오류를 방지할 수 있습니다.

컨테이너형 애플리케이션이 Artifact Registry와 같은 이미지 레지스트리에 저장되어 있는지 확인합니다.
GKE를 처음 사용하는 경우, GKE API를 사용 설정하고 제품의 작동 방식을 배울 수 있는 빠른 시작을 완료해야 합니다.

배포 심층 분석

다음은 간단한 배포 매니페스트 파일의 예입니다. 이 배포는 Artifact Registry에 저장된 hello-app 이미지를 실행하는 app=my-app으로 라벨이 지정된 3개의 복제된 포드를 만듭니다.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-app
spec:
  replicas: 3
  selector:
    matchLabels:
      run: my-app
  template:
    metadata:
      labels:
        run: my-app
    spec:
      containers:
      - name: hello-app
        image: us-docker.pkg.dev/google-samples/containers/gke/hello-app:1.0

이 예에서는 다음과 같이 정의됩니다.

.spec.replicas: 배포에서 관리하는 복제된 포드 수입니다.
.spec.template.metadata.labels: 배포에서 포드 관리를 위해 사용하는 각 포드에 지정된 라벨입니다.
.spec.template.spec: 각 포드의 실행 방법을 정의하는 포드 사양입니다. spec.containers에는 각 포드에서 실행할 컨테이너의 이름과 실행할 컨테이너 이미지가 포함됩니다.

배포 사양에 대한 자세한 내용은 배포 API 참조를 참조하세요.

배포 만들기

다음 방법 중 하나를 사용하여 배포를 만듭니다.

Google Cloud 콘솔의 워크로드 메뉴에서 배포 기능을 사용하면 Artifact Registry에 저장한 컨테이너 이미지로 간단한 배포를 만들 수 있습니다.
배포 매니페스트를 작성하고 kubectl apply를 실행하여 리소스를 만들 수 있습니다.

kubectl apply

kubectl apply를 사용하여 매니페스트 파일로부터 배포를 선언적으로 만들고 업데이트할 수 있습니다. 이 메서드는 또한 변경사항을 매니페스트 파일에 다시 병합하지 않고도 실시간 리소스에 적용된 업데이트를 보관합니다.

해당 매니페스트 파일에서 배포를 만들려면 다음 명령어를 실행하세요.

kubectl apply -f DEPLOYMENT_FILE

DEPLOYMENT_FILE을 config.yaml과 같이 매니페스트 파일로 바꿉니다.

kubectl apply -f DIRECTORY/를 사용하여 디렉터리에 저장된 매니페스트 파일에 정의된 모든 객체(기존 항목 제외)를 만들 수 있습니다.

콘솔

배포를 만들려면 다음 단계를 수행하세요.

Google Cloud 콘솔에서 워크로드 페이지로 이동합니다.

워크로드로 이동
배포를 클릭합니다.
컨테이너 지정에서 다음 중 하나를 선택합니다.
- 기존 컨테이너 이미지 - Artifact Registry 또는 DockerHub에서 제공되는 컨테이너 이미지를 선택할 수 있습니다. 이미지 경로에 컨테이너 이미지와 버전의 경로를 입력합니다.
- Cloud Source Repositories 및 Cloud Build로 만든 이미지를 사용하기 위한 새 컨테이너 이미지
원할 경우 다음을 사용하여 배포를 구성합니다.
- 환경 변수 - 컨테이너에 전달할 수 있습니다.
- 런타임에 컨테이너의 진입점을 맞춤 설정할 초기 명령어
완료를 클릭한 다음 계속을 클릭합니다.
구성 섹션에서 배포에 애플리케이션 이름을 부여하고 배포할 Kubernetes 네임스페이스를 지정합니다.
필요한 경우 라벨에서 Kubernetes 라벨을 배포에 추가할 수 있습니다.
이 배포를 생성한 YAML을 저장한 후 나중에 업데이트하려면 YAML 보기를 클릭합니다. YAML을 복사하여 파일에 붙여넣은 후 저장하고 YAML 출력 대화상자에서 닫기를 클릭합니다.
Kubernetes 클러스터 드롭다운 메뉴에서 원하는 클러스터를 선택합니다.
배포를 클릭합니다.

배포 조사

배포를 만든 후에는 다음 방법 중 하나를 사용하여 이를 조사할 수 있습니다.

워크로드 메뉴를 사용할 수 있습니다.
kubectl describe 및 kubectl get을 사용할 수 있습니다.

kubectl

배포에 대한 자세한 정보를 보려면 다음 명령어를 실행하세요.

kubectl describe deployment DEPLOYMENT_NAME

DEPLOYMENT_NAME을 배포 이름으로 바꿉니다.

배포에서 생성된 포드를 나열하려면 다음 명령어를 실행하세요.

kubectl get pods -l KEY=VALUE

이 명령어에서 -l 플래그는 kubectl이 키-값 라벨이 지정된 모든 포드를 가져오도록 지시합니다. 예를 들어 배포의 라벨을 app: my-app으로 지정한 경우 해당 라벨이 지정된 포드를 보려면 kubectl get pods -l app=my-app을 실행해야 합니다.

특정 포드에 대한 정보를 가져오려면 다음을 실행하세요.

kubectl describe pod POD_NAME

배포의 매니페스트를 보려면 다음 명령어를 실행하세요.

kubectl get deployments DEPLOYMENT_NAME -o yaml

이 명령어는 배포의 실시간 구성을 YAML 형식으로 표시합니다.

콘솔

배포를 조사하려면 다음 단계를 수행하세요.

Google Cloud 콘솔에서 워크로드 페이지로 이동합니다.

워크로드로 이동
워크로드 목록에서 검사하려는 배포의 이름을 클릭합니다.
배포 세부정보 페이지에서 다음 중 하나를 수행합니다.
- 업데이트 기록 탭을 클릭하여 배포의 업데이트 기록을 확인합니다.
- 이벤트 탭을 클릭하여 배포와 관련된 모든 이벤트를 확인합니다.
- 로그 탭을 클릭하여 배포의 컨테이너 활동 로그를 봅니다.
- YAML 탭을 클릭하여 배포의 YAML 매니페스트를 확인, 복사, 다운로드합니다.

배포 업데이트

이미지, 리소스 사용/요청 또는 구성과 같이, 배포의 포드 사양에 업데이트를 롤아웃할 수 있습니다.

다음 방법을 사용하여 배포를 업데이트할 수 있습니다.

순차적 업데이트 메뉴와 Google Cloud 콘솔 워크로드 메뉴의 YAML 편집기를 사용할 수 있습니다.
매니페스트 파일을 변경하고 kubectl apply로 이를 적용할 수 있습니다.
kubectl set를 사용하여 포드 사양의 image, resources 또는 selector 필드를 업데이트할 수 있습니다.
셸에서 직접 또는 kubectl edit를 사용하여 원하는 편집기에서 배포를 업데이트할 수 있습니다.

kubectl apply

신규 또는 업데이트된 매니페스트 파일을 적용하여 배포를 업데이트할 수 있습니다. 이 방법은 확장하거나 애플리케이션의 새 버전을 지정하는 등 배포를 다양하게 변경하는 경우에 유용합니다.

배포를 업데이트하려면 다음 명령어를 실행하세요.

kubectl apply -f DEPLOYMENT_FILE

DEPLOYMENT_FILE을 업데이트된 매니페스트 파일로 바꿉니다.

kubectl apply 명령어는 매니페스트 파일을 리소스에 적용합니다. 지정된 리소스가 없으면 명령어를 통해 생성됩니다,

kubectl set

kubectl set 명령어를 사용하여 배포 이미지, 리소스(요청 또는 제한) 또는 선택기 필드를 변경할 수 있습니다.

배포 이미지를 변경하려면 다음 명령어를 실행하세요.

kubectl set image deployment DEPLOYMENT_NAME IMAGE IMAGE:TAG

예를 들어 배포를 nginx 버전 1.7.9에서 1.9.1로 업데이트하려면 다음 명령어를 실행합니다.

kubectl set image deployment nginx nginx=nginx:1.9.1

콘솔

배포의 순차적 업데이트 메뉴에 액세스하려면 다음 안내를 따르세요.

Google Cloud 콘솔에서 워크로드 페이지로 이동합니다.

워크로드로 이동
워크로드 목록에서 수정하려는 배포의 이름을 클릭합니다.
작업 > 순차적 업데이트를 클릭합니다.
업데이트 전략에 다음 선택적 매개변수를 구성합니다.
- 최소 준비 기간(초): 새로 생성된 포드가 사용 가능한 상태로 간주될 때까지 기다려야 하는 최소 시간(초)을 지정합니다.
- 최대 초과 개수: 원하는 포드 수를 넘어서 생성될 수 있는 최대 포드 수를 지정합니다. 값은 절대 숫자이거나 백분율일 수 있습니다.
- 최대 사용 불가 개수: 업데이트 프로세스 동안 사용 불가 상태로 될 수 있는 최대 포드 수를 지정합니다. 값은 절대 숫자이거나 백분율일 수 있습니다.
컨테이너 이미지에서 업데이트된 컨테이너 이미지의 이미지 경로와 버전을 입력합니다.
업데이트를 클릭합니다.

업데이트 롤백

kubectl rollout undo를 사용하여 업데이트를 롤백할 수 있습니다.

진행 중인 또는 완료된 업데이트를 이전 버전으로 롤백할 수 있습니다.

kubectl rollout undo deployment my-deployment

또한 특정 버전으로 롤백할 수도 있습니다.

kubectl rollout undo deployment my-deployment --to-revision=3

배포 확장

Google Cloud 콘솔이나 kubectl scale을 사용하여 배포를 수동으로 확장할 수 있습니다.

배포 자동 확장에 대해 자세히 알아보세요.

kubectl

kubectl scale을 사용하여 언제든지 배포를 확장할 수 있습니다.

배포를 수동으로 확장하려면 다음 명령어를 실행하세요.

kubectl scale deployment DEPLOYMENT_NAME --replicas NUMBER_OF_REPLICAS

NUMBER_OF_REPLICAS를 원하는 복제된 포드 수로 바꿉니다.

콘솔

배포를 확장하려면 다음 단계를 수행하세요.

Google Cloud 콘솔에서 워크로드 페이지로 이동합니다.

워크로드로 이동
워크로드 목록에서 수정하려는 배포의 이름을 클릭합니다.
작업 > 확장 > 복제본 수정을 클릭합니다.
배포의 새 복제본 수를 입력합니다.
확장을 클릭합니다.

배포 삭제

Google Cloud 콘솔이나 kubectl delete를 사용하여 배포를 삭제할 수 있습니다.

kubectl

배포를 삭제하려면 다음 명령어를 실행하세요.

kubectl delete deployment DEPLOYMENT_NAME

콘솔

배포를 삭제하려면 다음 단계를 수행하세요.

Google Cloud 콘솔에서 워크로드 페이지로 이동합니다.

워크로드로 이동
워크로드 목록에서 삭제할 배포를 하나 이상 선택합니다.
삭제를 클릭합니다.
확인 메시지가 나타나면 삭제를 클릭합니다.