빠른 시작

이 빠른 시작에서는 Google Kubernetes Engine(GKE) 클러스터에 간단한 웹 서버 컨테이너식 애플리케이션을 배포합니다. 클러스터를 만드는 방법과 사용자가 액세스할 수 있도록 애플리케이션을 클러스터에 배포하는 방법을 설명합니다.

이 빠른 시작에서는 대상 독자가 Kubernetes에 대한 기본적인 지식이 있다고 가정합니다.

이 페이지의 단계를 따르거나 Google Cloud 교육 실습으로 빠른 시작을 사용할 수 있습니다.

실습에 사용해보기

시작하기 전에

다음 단계에 따라 Kubernetes Engine API를 사용 설정합니다.
  1. Google Cloud Console에서 Kubernetes Engine 페이지로 이동합니다.
  2. 프로젝트를 만들거나 선택합니다.
  3. API 및 관련 서비스가 사용 설정될 때까지 기다립니다. 몇 분 정도 걸릴 수 있습니다.
  4. Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

할당량 요구사항

이 빠른 시작을 완료하려면 다음에 대한 사용 가능한 할당량이 필요합니다.

  • 클러스터의 리전의 Compute Engine CPU 1개
  • 사용 중인 IP 주소 1개

사용 가능한 할당량을 확인하려면 Cloud Console을 사용하세요.

셸 선택

이 빠른 시작을 완료하려면 Cloud Shell 또는 로컬 셸을 사용하면 됩니다.

Cloud Shell은 Google Cloud에서 호스팅되는 리소스를 관리하는 데 사용되는 셸 환경입니다. Cloud Shell에는 gcloud 명령줄 도구kubectl 명령줄 도구가 사전 설치되어 있습니다. gcloud 도구는 Google Cloud의 기본 명령줄 인터페이스를 제공하며, kubectl은 Kubernetes 클러스터를 대상으로 명령어를 실행할 수 있는 기본 명령줄 인터페이스를 제공합니다.

로컬 셸을 사용하려면 gcloud 도구와 kubectl 도구를 환경에 설치해야 합니다.

Cloud Shell

Cloud Shell을 시작하려면 다음 단계를 수행하세요.

  1. Google Cloud Console로 이동합니다.

    Google Cloud Console

  2. Console의 오른쪽 상단에서 Cloud Shell 활성화 버튼을 클릭합니다.

Console 하단의 프레임에서 Cloud Shell 세션이 열립니다. 이 셸을 사용하여 gcloudkubectl 명령어를 실행합니다.

로컬 셸

gcloudkubectl을 설치하려면 다음 단계를 수행하세요.

  1. gcloud 명령줄 도구가 포함된 Cloud SDK를 설치합니다.
  2. Cloud SDK를 설치한 후 다음 명령어를 실행하여 kubectl 명령줄 도구를 설치합니다.

    gcloud components install kubectl

gcloud 도구의 기본 설정 구성

gcloud 도구를 사용하여 기본 프로젝트컴퓨팅 영역 등 두 가지 기본 설정을 구성합니다.

프로젝트에는 고유 식별자인 프로젝트 ID가 있습니다. 프로젝트를 처음 만들 때 자동 생성되는 프로젝트 ID를 사용하거나 사용자 고유의 ID를 만들 수 있습니다.

컴퓨팅 영역은 클러스터와 리소스가 존재하는 리전의 위치입니다. 예를 들어 us-west1-aus-west 리전의 영역입니다.

gcloud를 사용하려면 작업할 프로젝트와 컴퓨팅 영역을 지정해야 하므로 이러한 기본 설정을 구성하면 gcloud 명령어를 더욱 쉽게 실행할 수 있습니다. --project, --zone, --cluster와 같은 플래그를 gcloud 명령어에 사용하여 이러한 설정을 지정하거나 기본 설정을 재정의할 수 있습니다.

기본 프로젝트와 컴퓨팅 영역을 구성한 후 GKE 리소스를 만들면 프로젝트와 영역에 리소스가 자동으로 생성됩니다.

기본 프로젝트 설정

다음 명령어를 실행합니다. 이때 project-id를 프로젝트 ID로 바꿉니다.

gcloud config set project project-id

기본 컴퓨팅 영역 설정

다음 명령어를 실행합니다. 이때 compute-zone을 컴퓨팅 영역(예: us-west1-a)으로 바꿉니다.

gcloud config set compute/zone compute-zone

GKE 클러스터 만들기

클러스터클러스터 제어 영역 머신 최소 한 개 이상과 노드라는 작업자 머신 여러 개로 구성됩니다. 노드는 클러스터를 구성하기 위해 필요한 Kubernetes 프로세스를 실행하는 Compute Engine 가상 머신(VM) 인스턴스입니다. 클러스터에 애플리케이션을 배포하고 애플리케이션은 노드에서 실행됩니다.

다음 명령어는 단일 노드 클러스터를 만듭니다. cluster-name을 클러스터 이름으로 바꿉니다.

gcloud container clusters create cluster-name --num-nodes=1

클러스터의 사용자 인증 정보 가져오기

클러스터를 만든 후 클러스터와 상호작용하려면 사용자 인증 정보를 가져와야 합니다.

gcloud container clusters get-credentials cluster-name

이 명령어는 생성한 클러스터를 사용하도록 kubectl을 구성합니다.

클러스터에 애플리케이션 배포하기

클러스터가 생성되었으므로 이제 컨테이너식 애플리케이션을 배포할 수 있습니다. 이 빠른 시작에서는 예시 웹 애플리케이션(hello-app)을 배포 할 수 있습니다.

GKE는 Kubernetes 객체를 사용하여 클러스터의 리소스를 만들고 관리합니다. Kubernetes는 웹 서버와 같은 스테이트리스(Stateless) 애플리케이션을 배포하기 위한 배포 객체를 제공합니다. 서비스 객체는 인터넷에서 애플리케이션에 액세스하기 위한 규칙과 부하 분산을 정의합니다.

배포 만들기

클러스터에서 hello-app을 실행하려면 다음 명령어를 실행하세요.

kubectl create deployment hello-server --image=gcr.io/google-samples/hello-app:1.0

이 Kubernetes 명령어 kubectl create deploymenthello-server라는 배포를 만듭니다. 배포의 Podhello-app 컨테이너 이미지를 실행합니다.

이 명령어에서 각 항목의 의미는 다음과 같습니다.

  • --image는 배포할 컨테이너 이미지를 지정합니다. 이 경우 명령어는 예시 이미지를 Container Registry 버킷 gcr.io/google-samples/hello-app에서 가져옵니다. :1.0은 가져올 특정 이미지 버전을 나타냅니다. 버전을 지정하지 않으면 최신 버전이 사용됩니다.

배포 노출

애플리케이션을 배포한 후에는 사용자가 액세스할 수 있도록 이를 인터넷에 노출해야 합니다. 애플리케이션을 외부 트래픽에 노출하는 Kubernetes 리소스인 서비스를 만들어 애플리케이션을 노출할 수 있습니다.

애플리케이션을 노출하려면 다음 kubectl expose 명령어를 실행합니다.

kubectl expose deployment hello-server --type LoadBalancer \
  --port 80 --target-port 8080

--type LoadBalancer 플래그를 전달하면 컨테이너의 Compute Engine 부하 분산기가 생성됩니다. --port 플래그는 인터넷에 공개 포트 80을 초기화하고 --target-port 플래그는 트래픽을 애플리케이션의 포트 8080으로 라우팅합니다.

부하 분산기는 Compute Engine의 부하 분산기 가격 책정에 따라 요금이 청구됩니다.

애플리케이션 검사 및 보기

  1. kubectl get pods를 사용하여 실행 중인 Pod를 검사합니다.

    kubectl get pods

    클러스터에서 하나의 hello-server Pod가 실행 중임을 볼 수 있을 것입니다.

  2. kubectl get service를 사용하여 hello-server 서비스를 검사합니다.

    kubectl get service hello-server

    이 명령어의 출력에서 EXTERNAL-IP 열에 있는 서비스의 외부 IP 주소를 복사합니다.

  3. 외부 IP 주소와 노출된 포트를 사용하여 웹브라우저에서 애플리케이션을 확인합니다.

    http://external-ip/

GKE에 컨테이너식 웹 애플리케이션을 배포했습니다.

삭제

이 빠른 시작에서 사용한 리소스에 대한 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행하세요.

  1. kubectl delete를 실행하여 애플리케이션의 서비스를 삭제합니다.

    kubectl delete service hello-server

    이 명령어는 배포를 노출할 때 만든 Compute Engine 부하 분산기를 삭제합니다.

  2. gcloud container clusters delete를 실행하여 클러스터를 삭제합니다.

    gcloud container clusters delete cluster-name

선택사항: hello-app 코드 검토

hello-app은 간단한 웹 서버 애플리케이션으로 main.goDockerfile, 두 파일로 구성됩니다.

hello-appDocker 컨테이너 이미지로 패키징됩니다. 컨테이너 이미지는 Container Registry와 같은 Docker 이미지 레지스트리에 저장됩니다. hello-appgcr.io/google-samples/hello-app이라는 Container Registry 버킷에 호스팅됩니다.

main.go

main.goGo 프로그래밍 언어로 작성된 웹 서버 구현입니다. 서버는 모든 HTTP 요청에 'Hello, world!'라는 메시지로 응답합니다.

package main

import (
	"fmt"
	"log"
	"net/http"
	"os"
)

func main() {
	// register hello function to handle all requests
	mux := http.NewServeMux()
	mux.HandleFunc("/", hello)

	// use PORT environment variable, or default to 8080
	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}

	// start the web server on port and accept requests
	log.Printf("Server listening on port %s", port)
	log.Fatal(http.ListenAndServe(":"+port, mux))
}

// hello responds to the request with a plain-text "Hello, world" message.
func hello(w http.ResponseWriter, r *http.Request) {
	log.Printf("Serving request: %s", r.URL.Path)
	host, _ := os.Hostname()
	fmt.Fprintf(w, "Hello, world!\n")
	fmt.Fprintf(w, "Version: 1.0.0\n")
	fmt.Fprintf(w, "Hostname: %s\n", host)
}

Dockerfile

Dockerfile은 모든 리소스와 종속 항목을 비롯하여 Docker가 빌드할 이미지를 설명하고 앱이 노출해야 하는 네트워크 포트를 지정합니다. 이 파일의 작동 방식에 대한 자세한 내용은 Docker 문서의 Dockerfile 참조를 확인하세요.

FROM golang:1.8-alpine
ADD . /go/src/hello-app
RUN go install hello-app

FROM alpine:latest
COPY --from=0 /go/bin/hello-app .
ENV PORT 8080
CMD ["./hello-app"]

다음 단계