Merge pull request #42044 from jongwooo/230717_ko_update_outdated_files
[ko] Update outdated files in dev-1.27-ko.1 (M118-M126)pull/43196/head
Kubernetes Prow Robot
GitHub
commit
dccd3d7faa
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: "클러스터 내 어플리케이션 접근"
|
||||
description: 클러스터의 애플리케이션에 접근하기 위해 로드 밸런싱, 포트 포워딩, 방화벽 설정 또는 DNS 구성을 설정한다.
|
||||
weight: 60
|
||||
weight: 100
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,7 @@
|
|||
---
|
||||
title: 클러스터에서 실행되는 서비스에 접근
|
||||
content_type: task
|
||||
weight: 140
|
||||
---
|
||||
|
||||
<!-- overview -->
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
title: 공유 볼륨을 이용하여 동일한 파드의 컨테이너 간에 통신하기
|
||||
content_type: task
|
||||
weight: 110
|
||||
weight: 120
|
||||
---
|
||||
|
||||
<!-- overview -->
|
||||
|
|
|
|||
|
|
@ -404,7 +404,7 @@ $Env:KUBECONFIG=$ENV:KUBECONFIG_SAVED
|
|||
동시에 두 개 이상의 클러스터를 관리하는 경우 훨씬 더 어려울 수 있다.
|
||||
|
||||
선택되어 있는 쿠버네티스 컨텍스트의 사용자 이름 등에 대한,
|
||||
주체 속성을 확인하기 위한 'kubectl' 알파 하위 명령 `kubectl alpha auth whoami`이 있다.
|
||||
주체 속성을 확인하기 위한 'kubectl' 하위 명령 `kubectl auth whoami`이 있다.
|
||||
|
||||
더 자세한 내용은 [클라이언트의 인증 정보에 대한 API 액세스](/docs/reference/access-authn-authz/authentication/#self-subject-review)
|
||||
를 확인한다.
|
||||
|
|
|
|||
|
|
@ -1,6 +1,6 @@
|
|||
---
|
||||
title: 클러스터의 DNS 구성하기
|
||||
weight: 120
|
||||
weight: 130
|
||||
content_type: concept
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
title: NGINX 인그레스(Ingress) 컨트롤러로 Minikube에서 인그레스 설정하기
|
||||
content_type: task
|
||||
weight: 100
|
||||
weight: 110
|
||||
min-kubernetes-server-version: 1.19
|
||||
---
|
||||
|
||||
|
|
@ -10,26 +10,19 @@ min-kubernetes-server-version: 1.19
|
|||
[인그레스](/ko/docs/concepts/services-networking/ingress/)는 클러스터의 서비스에 대한 외부 액세스를 허용하는 규칙을 정의하는
|
||||
API 객체이다. [인그레스 컨트롤러](/ko/docs/concepts/services-networking/ingress-controllers/)는 인그레스에 설정된 규칙을 이행한다.
|
||||
|
||||
이 페이지에서는 HTTP URI에 따라 요청을 Service web 또는 web2로 라우팅하는 간단한 인그레스를 설정하는 방법을 보여준다.
|
||||
|
||||
|
||||
이 페이지에서는 HTTP URI에 따라 요청을 Service 'web' 또는 'web2'로 라우팅하는 간단한 인그레스를 설정하는 방법을 보여준다.
|
||||
|
||||
## {{% heading "prerequisites" %}}
|
||||
|
||||
이 튜토리얼은 로컬 쿠버네티스 클러스터를 실행하기 위해 `minikube`를 사용한다고 가정한다.
|
||||
`minikube`를 설치하는 방법은 [도구 설치하기](/ko/docs/tasks/tools/#minikube)를 참고한다.
|
||||
|
||||
{{< include "task-tutorial-prereqs.md" >}} {{< version-check >}}
|
||||
만약 이보다 더 이전 버전의 쿠버네티스를 사용하고 있다면,
|
||||
해당 쿠버네티스 버전의 문서를 참고한다.
|
||||
|
||||
만약 이보다 더 이전 버전의 쿠버네티스를 사용하고 있다면, 해당 쿠버네티스 버전의 문서를 참고한다.
|
||||
|
||||
### Minikube 클러스터 생성하기
|
||||
|
||||
Katacoda 활용하기
|
||||
: {{< kat-button >}}
|
||||
|
||||
로컬에서 생성하기
|
||||
: 이미 로컬에 [Minikube를 설치](/ko/docs/tasks/tools/#minikube)했다면,
|
||||
`minikube start`를 실행하여 클러스터를 생성한다.
|
||||
로컬에 클러스터를 설정하지 않았다면, 클러스터를 생성하기 위해 `minikube start`를 실행한다.
|
||||
|
||||
<!-- steps -->
|
||||
|
||||
|
|
@ -37,114 +30,90 @@ Katacoda 활용하기
|
|||
|
||||
1. NGINX 인그레스 컨트롤러를 활성화하기 위해 다음 명령을 실행한다.
|
||||
|
||||
```shell
|
||||
minikube addons enable ingress
|
||||
```
|
||||
```shell
|
||||
minikube addons enable ingress
|
||||
```
|
||||
|
||||
1. NGINX 인그레스 컨트롤러가 실행 중인지 확인한다.
|
||||
|
||||
```shell
|
||||
kubectl get pods -n ingress-nginx
|
||||
```
|
||||
|
||||
{{< tabs name="tab_with_md" >}}
|
||||
{{% tab name="minikube v1.19 or later" %}}
|
||||
```shell
|
||||
kubectl get pods -n ingress-nginx
|
||||
```
|
||||
{{< note >}}파드가 정상적으로 실행되기까지 1분 정도 소요될 수 있다.{{< /note >}}
|
||||
{{< note >}}
|
||||
파드가 정상적으로 실행되기까지 1분 정도 소요될 수 있다.
|
||||
{{< /note >}}
|
||||
|
||||
결과는 다음과 같다.
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
NAME READY STATUS RESTARTS AGE
|
||||
ingress-nginx-admission-create-g9g49 0/1 Completed 0 11m
|
||||
ingress-nginx-admission-patch-rqp78 0/1 Completed 1 11m
|
||||
ingress-nginx-controller-59b45fb494-26npt 1/1 Running 0 11m
|
||||
```
|
||||
{{% /tab %}}
|
||||
{{% tab name="minikube v1.18.1 or earlier" %}}
|
||||
```shell
|
||||
kubectl get pods -n kube-system
|
||||
```
|
||||
{{< note >}}파드가 정상적으로 실행되기까지 1분 정도 소요될 수 있다.{{< /note >}}
|
||||
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
NAME READY STATUS RESTARTS AGE
|
||||
default-http-backend-59868b7dd6-xb8tq 1/1 Running 0 1m
|
||||
kube-addon-manager-minikube 1/1 Running 0 3m
|
||||
kube-dns-6dcb57bcc8-n4xd4 3/3 Running 0 2m
|
||||
kubernetes-dashboard-5498ccf677-b8p5h 1/1 Running 0 2m
|
||||
nginx-ingress-controller-5984b97644-rnkrg 1/1 Running 0 1m
|
||||
storage-provisioner 1/1 Running 0 2m
|
||||
```
|
||||
|
||||
`nginx-ingress-controller-`로 시작하는 파드가 있는지 확인한다.
|
||||
{{% /tab %}}
|
||||
{{< /tabs >}}
|
||||
```none
|
||||
NAME READY STATUS RESTARTS AGE
|
||||
ingress-nginx-admission-create-g9g49 0/1 Completed 0 11m
|
||||
ingress-nginx-admission-patch-rqp78 0/1 Completed 1 11m
|
||||
ingress-nginx-controller-59b45fb494-26npt 1/1 Running 0 11m
|
||||
```
|
||||
|
||||
## hello, world 앱 배포하기
|
||||
|
||||
1. 다음 명령을 사용하여 디플로이먼트(Deployment)를 생성한다.
|
||||
|
||||
```shell
|
||||
kubectl create deployment web --image=gcr.io/google-samples/hello-app:1.0
|
||||
```
|
||||
```shell
|
||||
kubectl create deployment web --image=gcr.io/google-samples/hello-app:1.0
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
deployment.apps/web created
|
||||
```
|
||||
```none
|
||||
deployment.apps/web created
|
||||
```
|
||||
|
||||
1. 디플로이먼트를 노출시킨다.
|
||||
|
||||
```shell
|
||||
kubectl expose deployment web --type=NodePort --port=8080
|
||||
```
|
||||
```shell
|
||||
kubectl expose deployment web --type=NodePort --port=8080
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
service/web exposed
|
||||
```
|
||||
```none
|
||||
service/web exposed
|
||||
```
|
||||
|
||||
1. 서비스(Service)가 생성되고 노드 포트에서 사용할 수 있는지 확인한다.
|
||||
|
||||
```shell
|
||||
kubectl get service web
|
||||
```
|
||||
```shell
|
||||
kubectl get service web
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
|
||||
web NodePort 10.104.133.249 <none> 8080:31637/TCP 12m
|
||||
```
|
||||
```none
|
||||
NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE
|
||||
web NodePort 10.104.133.249 <none> 8080:31637/TCP 12m
|
||||
```
|
||||
|
||||
1. 노드포트(NodePort)를 통해 서비스에 접속한다.
|
||||
|
||||
```shell
|
||||
minikube service web --url
|
||||
```
|
||||
```shell
|
||||
minikube service web --url
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
http://172.17.0.15:31637
|
||||
```
|
||||
```none
|
||||
http://172.17.0.15:31637
|
||||
```
|
||||
|
||||
{{< note >}}Katacoda 환경만 해당: 터미널 패널 상단에서 더하기 기호를 클릭한 다음 **Select port to view on Host 1**을 클릭한다. 노드포트(이 경우 '31637')를 입력한 다음 **Display Port**를 클릭한다.{{< /note >}}
|
||||
결과는 다음과 같다.
|
||||
|
||||
결과는 다음과 같다.
|
||||
```none
|
||||
Hello, world!
|
||||
Version: 1.0.0
|
||||
Hostname: web-55b8c6998d-8k564
|
||||
```
|
||||
|
||||
```
|
||||
Hello, world!
|
||||
Version: 1.0.0
|
||||
Hostname: web-55b8c6998d-8k564
|
||||
```
|
||||
|
||||
이제 Minikube IP 주소와 노드포트를 통해 샘플 앱에 액세스할 수 있다. 다음 단계에서는
|
||||
인그레스 리소스를 사용하여 앱에 액세스할 수 있다.
|
||||
이제 Minikube IP 주소와 노드포트를 통해 샘플 애플리케이션에 액세스할 수 있다. 다음 단계에서는
|
||||
인그레스 리소스를 사용하여 애플리케이션에 액세스할 수 있다.
|
||||
|
||||
## 인그레스 생성하기
|
||||
|
||||
|
|
@ -156,145 +125,154 @@ storage-provisioner 1/1 Running 0 2m
|
|||
|
||||
1. 다음 명령어를 실행하여 인그레스 오브젝트를 생성한다.
|
||||
|
||||
```shell
|
||||
kubectl apply -f https://k8s.io/examples/service/networking/example-ingress.yaml
|
||||
```
|
||||
```shell
|
||||
kubectl apply -f https://k8s.io/examples/service/networking/example-ingress.yaml
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
ingress.networking.k8s.io/example-ingress created
|
||||
```
|
||||
```none
|
||||
ingress.networking.k8s.io/example-ingress created
|
||||
```
|
||||
|
||||
1. IP 주소가 설정되었는지 확인한다.
|
||||
|
||||
```shell
|
||||
kubectl get ingress
|
||||
```
|
||||
```shell
|
||||
kubectl get ingress
|
||||
```
|
||||
|
||||
{{< note >}}이 작업은 몇 분 정도 소요될 수 있다.{{< /note >}}
|
||||
{{< note >}}
|
||||
이 작업은 몇 분 정도 소요될 수 있다.
|
||||
{{< /note >}}
|
||||
|
||||
다음 예시와 같이, ADDRESS 열에서 IPv4 주소를 확인할 수 있다.
|
||||
다음 예시와 같이, `ADDRESS` 열에서 IPv4 주소를 확인할 수 있다.
|
||||
|
||||
```
|
||||
NAME CLASS HOSTS ADDRESS PORTS AGE
|
||||
example-ingress <none> hello-world.info 172.17.0.15 80 38s
|
||||
```
|
||||
|
||||
1. 호스트 컴퓨터의 `/etc/hosts` 파일 맨 아래에
|
||||
다음 행을 추가한다 (관리자 권한 필요).
|
||||
|
||||
```
|
||||
172.17.0.15 hello-world.info
|
||||
```
|
||||
|
||||
{{< note >}}Minikube를 로컬에서 실행하는 경우 'minikube ip'를 사용하여 외부 IP를 가져온다. 인그레스 목록에 표시되는 IP 주소는 내부 IP가 된다.{{< /note >}}
|
||||
|
||||
이렇게 하면, 웹 브라우저가
|
||||
hello-world.info URL에 대한 요청을 Minikube로 전송한다.
|
||||
```
|
||||
NAME CLASS HOSTS ADDRESS PORTS AGE
|
||||
example-ingress <none> hello-world.info 172.17.0.15 80 38s
|
||||
```
|
||||
|
||||
1. 인그레스 컨트롤러가 트래픽을 전달하는지 확인한다.
|
||||
|
||||
```shell
|
||||
curl --resolve "hello-world.info:80:$( minikube ip )" -i http://hello-world.info
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
Hello, world!
|
||||
Version: 1.0.0
|
||||
Hostname: web-55b8c6998d-8k564
|
||||
```
|
||||
|
||||
브라우저에서도 `hello-world.info`에 접속할 수 있다.
|
||||
|
||||
* **선택 사항**
|
||||
Minikube에서 보고한 외부 IP 주소를 조회한다.
|
||||
|
||||
```shell
|
||||
curl hello-world.info
|
||||
minikube ip
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
호스트 컴퓨터의 `/etc/hosts` 파일 맨 아래에 다음 행을 추가한다 (관리자 권한 필요).
|
||||
|
||||
```
|
||||
Hello, world!
|
||||
Version: 1.0.0
|
||||
Hostname: web-55b8c6998d-8k564
|
||||
```none
|
||||
172.17.0.15 hello-world.info
|
||||
```
|
||||
|
||||
{{< note >}}Minikube를 로컬에서 실행하는 경우 브라우저에서 hello-world.info에 접속할 수 있다.{{< /note >}}
|
||||
{{< note >}}
|
||||
IP 주소를 `minikube ip`의 출력과 일치하도록 변경한다.
|
||||
{{< /note >}}
|
||||
|
||||
이 변경 사항을 적용하면 웹 브라우저가 `hello-world.info` URL에 대한 요청을 Minikube로 보낸다.
|
||||
|
||||
|
||||
## 두 번째 디플로이먼트 생성하기
|
||||
|
||||
1. 다음 명령을 사용하여 두 번째 디플로이먼트를 생성한다.
|
||||
|
||||
```shell
|
||||
kubectl create deployment web2 --image=gcr.io/google-samples/hello-app:2.0
|
||||
```
|
||||
결과는 다음과 같다.
|
||||
```shell
|
||||
kubectl create deployment web2 --image=gcr.io/google-samples/hello-app:2.0
|
||||
```
|
||||
|
||||
```
|
||||
deployment.apps/web2 created
|
||||
```
|
||||
결과는 다음과 같다.
|
||||
|
||||
```none
|
||||
deployment.apps/web2 created
|
||||
```
|
||||
|
||||
1. 두 번째 디플로이먼트를 노출시킨다.
|
||||
|
||||
```shell
|
||||
kubectl expose deployment web2 --port=8080 --type=NodePort
|
||||
```
|
||||
```shell
|
||||
kubectl expose deployment web2 --port=8080 --type=NodePort
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
service/web2 exposed
|
||||
```
|
||||
```none
|
||||
service/web2 exposed
|
||||
```
|
||||
|
||||
## 기존 인그레스 수정하기 {#edit-ingress}
|
||||
|
||||
1. 기존 `example-ingress.yaml` 매니페스트를 편집하고,
|
||||
하단에 다음 줄을 추가한다.
|
||||
1. 기존 `example-ingress.yaml` 매니페스트를 편집하고, 하단에 다음 줄을 추가한다.
|
||||
|
||||
```yaml
|
||||
- path: /v2
|
||||
pathType: Prefix
|
||||
backend:
|
||||
service:
|
||||
name: web2
|
||||
port:
|
||||
number: 8080
|
||||
- path: /v2
|
||||
pathType: Prefix
|
||||
backend:
|
||||
service:
|
||||
name: web2
|
||||
port:
|
||||
number: 8080
|
||||
```
|
||||
|
||||
1. 변경 사항을 적용한다.
|
||||
|
||||
```shell
|
||||
kubectl apply -f example-ingress.yaml
|
||||
```
|
||||
```shell
|
||||
kubectl apply -f example-ingress.yaml
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
ingress.networking/example-ingress configured
|
||||
```
|
||||
```none
|
||||
ingress.networking/example-ingress configured
|
||||
```
|
||||
|
||||
## 인그레스 테스트하기
|
||||
|
||||
1. Hello World 앱의 첫 번째 버전에 액세스한다.
|
||||
|
||||
```shell
|
||||
curl hello-world.info
|
||||
```
|
||||
```shell
|
||||
curl --resolve "hello-world.info:80:$( minikube ip )" -i http://hello-world.info
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
Hello, world!
|
||||
Version: 1.0.0
|
||||
Hostname: web-55b8c6998d-8k564
|
||||
```
|
||||
```none
|
||||
Hello, world!
|
||||
Version: 1.0.0
|
||||
Hostname: web-55b8c6998d-8k564
|
||||
```
|
||||
|
||||
1. Hello World 앱의 두 번째 버전에 액세스한다.
|
||||
|
||||
```shell
|
||||
curl hello-world.info/v2
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
|
||||
```
|
||||
Hello, world!
|
||||
Version: 2.0.0
|
||||
Hostname: web2-75cd47646f-t8cjk
|
||||
```
|
||||
|
||||
{{< note >}}Minikube를 로컬에서 실행하는 경우 브라우저에서 hello-world.info 및 hello-world.info/v2에 접속할 수 있다.{{< /note >}}
|
||||
```shell
|
||||
curl --resolve "hello-world.info:80:$( minikube ip )" -i http://hello-world.info/v2
|
||||
```
|
||||
|
||||
결과는 다음과 같다.
|
||||
|
||||
```none
|
||||
Hello, world!
|
||||
Version: 2.0.0
|
||||
Hostname: web2-75cd47646f-t8cjk
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
`/etc/hosts`를 업데이트하는 선택 사항을 수행했다면, 브라우저에서 `hello-world.info`와 `hello-world.info/v2`에 접속할 수 있다.
|
||||
{{< /note >}}
|
||||
|
||||
## {{% heading "whatsnext" %}}
|
||||
|
||||
|
|
|
|||
|
|
@ -98,7 +98,7 @@ weight: 60
|
|||
|
||||
결과는 아래와 같다.
|
||||
|
||||
```shell
|
||||
```none
|
||||
NAME READY STATUS ... IP NODE
|
||||
hello-world-2895499144-bsbk5 1/1 Running ... 10.200.1.4 worker1
|
||||
hello-world-2895499144-m1pwt 1/1 Running ... 10.200.2.5 worker2
|
||||
|
|
@ -127,7 +127,7 @@ weight: 60
|
|||
`<node-port>`는 서비스의 노드포트 값이다.
|
||||
성공적인 요청에 대한 응답은 hello 메시지이다.
|
||||
|
||||
```shell
|
||||
```none
|
||||
Hello Kubernetes!
|
||||
```
|
||||
|
||||
|
|
@ -152,4 +152,4 @@ weight: 60
|
|||
|
||||
튜토리얼
|
||||
[서비스와 애플리케이션 연결하기](/ko/docs/tutorials/services/connect-applications-service/)
|
||||
따라하기
|
||||
따라하기
|
||||
|
|
|
|||
|
|
@ -37,7 +37,7 @@ card:
|
|||
대시보드 UI는 기본으로 배포되지 않는다. 배포하려면 다음 커맨드를 실행한다.
|
||||
|
||||
```
|
||||
kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.6.1/aio/deploy/recommended.yaml
|
||||
kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml
|
||||
```
|
||||
|
||||
## 대시보드 UI 접근
|
||||
|
|
|
|||
Loading…
Reference in New Issue