Linux 컨테이너용 Kubernetes 클러스터 배포Deploy Kubernetes cluster for Linux containers

경고

지금 보고 있는 것은 이전 버전의 Azure Container Service에 대한 설명서입니다.You are viewing documentation for the old version of the Azure Container Service. Azure Kubernetes에 새 배포 옵션, 향상된 관리 기능 및 비용 혜택을 추가하기 위해 AKS(Azure Container Service)를 업데이트 중입니다.Azure Container Service (AKS) is being updated to add new deployment options, enhanced management capabilities, and cost benefit to Kubernetes on Azure. 이러한 미리 보기 기능으로 작업을 시작하려면 AKS 설명서를 참조하세요.Visit the AKS documentation to start working with these preview features.

이 빠른 시작에서는 Azure CLI를 사용하여 Kubernetes 클러스터가 배포됩니다.In this quick start, a Kubernetes cluster is deployed using the Azure CLI. 웹 프런트 엔드 및 Redis 인스턴스로 구성된 다중 컨테이너 응용 프로그램이 클러스터에 배포되어 실행됩니다.A multi-container application consisting of web front end and a Redis instance is then deployed and run on the cluster. 완료되면 인터넷을 통해 응용 프로그램에 액세스할 수 있습니다.Once completed, the application is accessible over the internet.

이 문서에서 사용된 응용 프로그램은 Python으로 작성되었습니다.The example application used in this document is written in Python. 여기에 상세하게 설명된 개념 및 단계는 Kubernetes 클러스터에 컨테이너 이미지를 배포하는 데 사용할 수 있습니다.The concepts and steps detailed here can be used to deploy any container image into a Kubernetes cluster. 이 프로젝트와 관련된 코드, Dockerfile 및 사전 생성된 Kubernetes 매니페스트 파일은 GitHub에 있습니다.The code, Dockerfile, and pre-created Kubernetes manifest files related to this project are available on GitHub.

Azure Vote로 이동하는 이미지

이 빠른 시작에서는 Kubernetes 개념에 대한 기본적인 이해가 있다고 가정하며 Kubernetes에 대한 자세한 정보는 Kubernetes 설명서를 참조하세요.This quick start assumes a basic understanding of Kubernetes concepts, for detailed information on Kubernetes see the Kubernetes documentation.

Azure 구독이 아직 없는 경우 시작하기 전에 무료 계정을 만듭니다.If you don't have an Azure subscription, create a free account before you begin.

Azure Cloud Shell 시작Launch Azure Cloud Shell

Azure Cloud Shell은 Azure Portal에서 직접 실행할 수 있는 평가판 Bash 셸입니다.The Azure Cloud Shell is a free Bash shell that you can run directly within the Azure portal. Azure CLI가 사전 설치되어 계정에서 사용하도록 구성되어 있습니다.It has the Azure CLI preinstalled and configured to use with your account. Azure Portal의 오른쪽 위 모서리에 있는 메뉴에서 Cloud Shell 단추를 클릭합니다.Click the Cloud Shell button on the menu in the upper-right of the Azure portal.

Cloud ShellCloud Shell

이 단추는 이 항목의 단계를 실행하는 데 사용할 수 있는 대화형 셸을 시작합니다.The button launches an interactive shell that you can use to run the steps in this topic:

포털에서 Cloud Shell 창을 보여 주는 스크린샷Screenshot showing the Cloud Shell window in the portal

CLI를 로컬로 설치하여 사용하도록 선택한 경우 이 빠른 시작에서 Azure CLI 버전 2.0.4 이상을 실행해야 합니다.If you choose to install and use the CLI locally, this quickstart requires that you are running the Azure CLI version 2.0.4 or later. az --version을 실행하여 버전을 찾습니다.Run az --version to find the version. 설치 또는 업그레이드해야 하는 경우 Azure CLI 2.0 설치를 참조하세요.If you need to install or upgrade, see Install Azure CLI 2.0.

리소스 그룹 만들기Create a resource group

az group create 명령을 사용하여 리소스 그룹을 만듭니다.Create a resource group with the az group create command. Azure 리소스 그룹은 Azure 리소스가 배포되고 관리되는 논리 그룹입니다.An Azure resource group is a logical group in which Azure resources are deployed and managed.

다음 예제에서는 westeurope 위치에 myResourceGroup이라는 리소스 그룹을 만듭니다.The following example creates a resource group named myResourceGroup in the westeurope location.

az group create --name myResourceGroup --location westeurope

출력:Output:

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup",
  "location": "westeurope",
  "managedBy": null,
  "name": "myResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

Kubernetes 클러스터 만들기Create Kubernetes cluster

az acs create 명령을 사용하여 Azure Container Service에서 Kubernetes 클러스터를 만듭니다.Create a Kubernetes cluster in Azure Container Service with the az acs create command. 다음 예제에서는 하나의 Linux 마스터 노드와 세 개의 Linux 에이전트 노드가 있는 myK8sCluster라는 클러스터를 만듭니다.The following example creates a cluster named myK8sCluster with one Linux master node and three Linux agent nodes.

az acs create --orchestrator-type kubernetes --resource-group myResourceGroup --name myK8sCluster --generate-ssh-keys

제한 평가판과 같이 Azure 구독의 Azure 리소스 액세스 권한이 제한되는 경우도 있습니다.In some cases, such as with a limited trial, an Azure subscription has limited access to Azure resources. 사용 가능한 코어 제한으로 인해 배포가 실패하는 경우 az acs create 명령에 --agent-count 1을 추가하여 기본 에이전트 수를 줄이세요.If the deployment fails due to limited available cores, reduce the default agent count by adding --agent-count 1 to the az acs create command.

몇 분 후 명령이 완료되고 클러스터에 대해 json으로 형식화된 정보가 반환됩니다.After several minutes, the command completes and returns json formatted information about the cluster.

클러스터에 연결Connect to the cluster

Kubernetes 클러스터를 관리하려면 Kubernetes 명령줄 클라이언트인 kubectl을 사용하세요.To manage a Kubernetes cluster, use kubectl, the Kubernetes command-line client.

Azure Cloud Shell을 사용하는 경우 kubectl이 이미 설치되어 있습니다.If you're using Azure CloudShell, kubectl is already installed. 로컬로 설치하려면 az acs kubernetes install-cli 명령을 사용하면 됩니다.If you want to install it locally, you can use the az acs kubernetes install-cli command.

Kubernetes 클러스터에 연결하도록 kubectl을 구성하려면 az acs kubernetes get-credentials 명령을 실행합니다.To configure kubectl to connect to your Kubernetes cluster, run the az acs kubernetes get-credentials command. 이 단계에서는 자격 증명을 다운로드하고 Kubernetes CLI가 자격 증명을 사용하도록 구성합니다.This step downloads credentials and configures the Kubernetes CLI to use them.

az acs kubernetes get-credentials --resource-group=myResourceGroup --name=myK8sCluster

클러스터에 대한 연결을 확인하려면 kubectl get 명령을 사용하여 클러스터 노드 목록을 반환합니다.To verify the connection to your cluster, use the kubectl get command to return a list of the cluster nodes.

kubectl get nodes

출력:Output:

NAME                    STATUS                     AGE       VERSION
k8s-agent-14ad53a1-0    Ready                      10m       v1.6.6
k8s-agent-14ad53a1-1    Ready                      10m       v1.6.6
k8s-agent-14ad53a1-2    Ready                      10m       v1.6.6
k8s-master-14ad53a1-0   Ready,SchedulingDisabled   10m       v1.6.6

응용 프로그램 실행Run the application

Kubernetes 매니페스트 파일은 어떤 컨테이너 이미지가 실행되는지 등과 같은 클러스터에 대해 원하는 상태를 정의합니다.A Kubernetes manifest file defines a desired state for the cluster, including what container images should be running. 이 예제에서는 Azure Vote 응용 프로그램을 실행하는 데 필요한 모든 개체를 만드는 데 매니페스트를 사용합니다.For this example, a manifest is used to create all objects needed to run the Azure Vote application.

azure-vote.yml이라는 파일을 만들고 다음 YAML에 복사합니다.Create a file named azure-vote.yml and copy into it the following YAML. Azure Cloud Shell에서 작업하고 있는 경우 이 파일은 가상 또는 실제 시스템에서 작업하고 있는 것처럼 vi 또는 Nano를 사용하여 만들 수 있습니다.If you are working in Azure Cloud Shell, this file can be created using vi or Nano as if working on a virtual or physical system.

apiVersion: apps/v1beta1
kind: Deployment
metadata:
  name: azure-vote-back
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: azure-vote-back
    spec:
      containers:
      - name: azure-vote-back
        image: redis
        ports:
        - containerPort: 6379
          name: redis
---
apiVersion: v1
kind: Service
metadata:
  name: azure-vote-back
spec:
  ports:
  - port: 6379
  selector:
    app: azure-vote-back
---
apiVersion: apps/v1beta1
kind: Deployment
metadata:
  name: azure-vote-front
spec:
  replicas: 1
  template:
    metadata:
      labels:
        app: azure-vote-front
    spec:
      containers:
      - name: azure-vote-front
        image: microsoft/azure-vote-front:redis-v1
        ports:
        - containerPort: 80
        env:
        - name: REDIS
          value: "azure-vote-back"
---
apiVersion: v1
kind: Service
metadata:
  name: azure-vote-front
spec:
  type: LoadBalancer
  ports:
  - port: 80
  selector:
    app: azure-vote-front

kubectl create 명령을 사용하여 응용 프로그램을 실행합니다.Use the kubectl create command to run the application.

kubectl create -f azure-vote.yml

출력:Output:

deployment "azure-vote-back" created
service "azure-vote-back" created
deployment "azure-vote-front" created
service "azure-vote-front" created

응용 프로그램 테스트Test the application

응용 프로그램을 실행하면 응용 프로그램 프런트 엔드를 인터넷에 공개하는 Kubernetes 서비스가 만들어집니다.As the application is run, a Kubernetes service is created that exposes the application front end to the internet. 이 프로세스를 완료하는 데 몇 분이 걸릴 수 있습니다.This process can take a few minutes to complete.

진행 상태를 모니터링하려면 --watch 인수와 함께 kubectl get service 명령을 사용합니다.To monitor progress, use the kubectl get service command with the --watch argument.

kubectl get service azure-vote-front --watch

처음에는 azure-vote-front 서비스에 대한 EXTERNAL-IP보류 중으로 표시됩니다.Initially the EXTERNAL-IP for the azure-vote-front service appears as pending. EXTERNAL-IP 주소가 보류 중에서 IP 주소로 변경되면 CTRL-C를 사용하여 kubectl 조사식 프로세스를 중지합니다.Once the EXTERNAL-IP address has changed from pending to an IP address, use CTRL-C to stop the kubectl watch process.

azure-vote-front   10.0.34.242   <pending>     80:30676/TCP   7s
azure-vote-front   10.0.34.242   52.179.23.131   80:30676/TCP   2m

이제 외부 IP 주소로 이동하여 Azure Vote 앱을 볼 수 있습니다.You can now browse to the external IP address to see the Azure Vote App.

Azure Vote로 이동하는 이미지

클러스터 삭제Delete cluster

클러스터가 더 이상 필요하지 않으면 az group delete 명령을 사용하여 리소스 그룹, 컨테이너 서비스 및 모든 관련 리소스를 제거할 수 있습니다.When the cluster is no longer needed, you can use the az group delete command to remove the resource group, container service, and all related resources.

az group delete --name myResourceGroup --yes --no-wait

코드 가져오기Get the code

이 빠른 시작에서는 Kubernetes 배포를 만드는 데 미리 생성된 컨테이너 이미지를 사용했습니다.In this quick start, pre-created container images have been used to create a Kubernetes deployment. 관련된 응용 프로그램 코드, Dockerfile 및 Kubernetes 매니페스트 파일을 GitHub에서 사용할 수 있습니다.The related application code, Dockerfile, and Kubernetes manifest file are available on GitHub.

https://github.com/Azure-Samples/azure-voting-app-redishttps://github.com/Azure-Samples/azure-voting-app-redis

다음 단계Next steps

이 빠른 시작에서는 Kubernetes 클러스터를 배포하고, 이 클러스터에 다중 컨테이너 응용 프로그램을 배포했습니다.In this quick start, you deployed a Kubernetes cluster and deployed a multi-container application to it.

Azure Container Service에 대해 자세히 알아보고 배포 예제에 대한 전체 코드를 연습해 보려면Kubernetes 클러스터 자습서를 계속 진행합니다.To learn more about Azure Container Service, and walk through a complete code to deployment example, continue to the Kubernetes cluster tutorial.