Skip to content
This repository has been archived by the owner on Oct 16, 2018. It is now read-only.

Translate tutorials/kubernetes-basics/expose in Korean #25

Closed
wants to merge 0 commits into from

Conversation

zer0big
Copy link
Contributor

@zer0big zer0big commented Aug 31, 2018

요청하신 Sync 처리 후 다시 PR 요청 드립니다.

@k8s-ci-robot k8s-ci-robot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Aug 31, 2018
@zer0big zer0big changed the title Dev 1.12 Translate tutorials/kubernetes-basics/expose in KoreanDev 1.12 Aug 31, 2018
@zer0big zer0big changed the title Translate tutorials/kubernetes-basics/expose in KoreanDev 1.12 Translate tutorials/kubernetes-basics/expose in Korean Aug 31, 2018
@gochist
Copy link
Contributor

gochist commented Aug 31, 2018

@zer0big
감사합니다! 다음 파일을 PR에서 빼주시면 리뷰를 시작하겠습니다.

content/ko/docs/home/expose-interactive.html
content/ko/docs/home/expose-intro.html

@zer0big
Copy link
Contributor Author

zer0big commented Aug 31, 2018

@gochist
두 파일 제거 반영했는데 요청하신 사항대로 처리 된건지 확인 부탁 드려요~

Copy link
Contributor

@gochist gochist left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

참고를 부탁드린 리뷰는 말 그대로 머지의 필수 조건이 아닙니다. 내용이 많지만 반영 부탁드립니다. 수정이 완료되면 단일 커밋으로 squash를 요청드리겠습니다.

@@ -1,4 +1,4 @@
---
title: Expose Your App Publicly
title: 여러분의 앱을 퍼블릭으로 노출하기
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

한국어는 주어가 겉으로 많이 드러나지 않는 언어라 번역 시 주어를 생략하는 편이 자연스러운 경우가 많습니다. 이대로도 의미는 통하므로 괜찮지만 저는 "여러분의" 를 생략하기를 권해드립니다. 참고해주세요.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

저는 #24 에서 "외부로"로 옮겼습니다. 참고해주세요. 원문의 다른 부분에 아래와 같은 문장도 있는데 같은 의미이기 때문입니다.

Expose an application outside a Kubernetes cluster using a Service

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

넵, 리뷰 주신대로 반영하겠습니다.

<h3>목표</h3>
<ul>
<li>쿠버네티스의 서비스에 대해 배운다.</li>
<li>레이블들과 레이블셀랙터 객체들이 어떻게 서비스와 연관되는지 이해한다.</li>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

현재 용어집 기준 "객체"는 "오브젝트"로 변경해주세요.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

복수형은 내용 상 중요하지 않은 경우 단수로 옮기는 것이 더 자연스럽습니다. 특히 아래에 나오는 "서비스들과 레이블들" 이라는 제목은 눈에 띄게 번역체입니다. 참고해주세요.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

넵, 수정하겠습니다.

</div>
</div>
<div class="row">
<div class="col-md-12">
<a class="btn btn-lg btn-success" href="/docs/tutorials/kubernetes-basics/scale-intro/" role="button">Continue
to Module 5<span class="btn__next">›</span></a>
<a class="btn btn-lg btn-success" href="/docs/tutorials/kubernetes-basics/scale-intro/" role="button">모듈 5에서 계속하기<span class="btn__next">›</span></a>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

저는 "모듈 X로 진행하기"로 옮겼습니다. 참고해주세요.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

넵, 일치시키겠습니다.

<div class="col-md-8">
<h3>쿠버네티스 서비스들에 대한 개요</h3>

<p>쿠버네티스 <a href="/docs/concepts/workloads/pods/pod-overview/">파드들</a> 은 언젠가는 죽게된다. 실제 파드들은 <a href="/docs/concepts/workloads/pods/pod-lifecycle/">생명주기</a>를 갖는다. 워커 노드가 죽으면, 노드 상에서 동작하는 파드들 또한 종료된다. A <a href="/docs/user-guide/replication-controller/#what-is-a-replicationcontroller">ReplicationController</a>는 여러분의 애플리케이션이 지속적으로 동작할 수 있도록 새로운 파드들의 생성을 통해 동적으로 클러스터를 미리 지정해 둔 상태로 되돌려 줄 수도 있다. 또 다른 예시로서, 3개의 복제본을 갖는 이미지 처리용 백엔드를 고려해 보자. 그 복제본들은 대체가능한 상태이다; 프론트엔드 시스템은 하나의 파드가 소멸되어 재생성이 되더라도, 백엔드 복제본들에 의한 영향을 받아서는 안된다. 즉, 동일 노드 상의 파드들이라 할지라도, 쿠버네티스 클러스터 내 각 파드는 유일한 IP 주소를 갖으며, 여러분의 애플리케이션들이 지속적으로 기능할 수 있도록 파드들 속에서 발생하는 변화에 대해 자동으로 조정해 줄 방법이 있어야 한다.</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

원문이 가로 폭을 기준으로 강제 개행한 경우 옮길 때도 같은 기준으로 개행을 해주는 것이 추후 변경 추적, 관리에 편리합니다. 참고해주세요.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

용어집에 따라 "A ReplicationController"는 "레플리케이션 컨트롤러"로 옮겨주세요.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

한국어는 세미콜론을 문장부호로 사용하지 않습니다. 문맥에 맞게 "그래서" 또는 "왜냐하면"의 의미로 옮겨주세요.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/갖으며/가지며/

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/대체가능/대체 가능/


<p>쿠버네티스 <a href="/docs/concepts/workloads/pods/pod-overview/">파드들</a> 은 언젠가는 죽게된다. 실제 파드들은 <a href="/docs/concepts/workloads/pods/pod-lifecycle/">생명주기</a>를 갖는다. 워커 노드가 죽으면, 노드 상에서 동작하는 파드들 또한 종료된다. A <a href="/docs/user-guide/replication-controller/#what-is-a-replicationcontroller">ReplicationController</a>는 여러분의 애플리케이션이 지속적으로 동작할 수 있도록 새로운 파드들의 생성을 통해 동적으로 클러스터를 미리 지정해 둔 상태로 되돌려 줄 수도 있다. 또 다른 예시로서, 3개의 복제본을 갖는 이미지 처리용 백엔드를 고려해 보자. 그 복제본들은 대체가능한 상태이다; 프론트엔드 시스템은 하나의 파드가 소멸되어 재생성이 되더라도, 백엔드 복제본들에 의한 영향을 받아서는 안된다. 즉, 동일 노드 상의 파드들이라 할지라도, 쿠버네티스 클러스터 내 각 파드는 유일한 IP 주소를 갖으며, 여러분의 애플리케이션들이 지속적으로 기능할 수 있도록 파드들 속에서 발생하는 변화에 대해 자동으로 조정해 줄 방법이 있어야 한다.</p>

<p>쿠버네티스에서 서비스는 하나의 논리적인 파드세트들과 그 파드들에 접근할 수 있는 정책을 정의하는 추상적 개념이다. 서비스는 독립적인 파드들 사이를 느슨하게 결합되도록 해준다. 서비스는 모든 쿠버네티스 오브젝트들과 같이 YAML <a href="/docs/concepts/configuration/overview/#general-config-tips">(preferred)</a> 또는 JSON을 이용하여 정의 되어진다. 서비스에 의해 대상으로 선정된 파드세트들은 보통 <i>LabelSelector</i>에 의해 결정되어 진다 (여러분이 왜 스펙 내에 <code>selector</code> 포함 없이 서비스를 필요로 하게 될 수도 있는지에 대해 아래에서 확인해 보자).</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"파드세트들"이 여러 번 나오는데, 띄어쓰기 해주시고, 원문에서 set은 단수입니다. "파드 세트" 또는 "파드의 집합"으로 고쳐주세요. 꼭 복수형을 유지하고자 하신다면 "파드들의 집합"도 괜찮습니다.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"독립적인"은 원문과 반대의 의미입니다.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

preferred 번역해주세요.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

동사 "정의하다"의 활용입니다. 붙여써주세요. 피동 표현의 중복도 고쳐주세요.
s/정의 되어진다/정의된다/

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

피동 표현의 중복입니다.
s/결정되어 진다/결정된다/

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

참고해주세요. 아래가 더 자연스러울 것 같습니다.
s/스펙 내에 selector 포함 없이 서비스를/스펙에 selector가 포함되지 않은 서비스를/

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

수동문을 능동문으로 바꿔주면 보다 자연스러운 번역이 되는 경우가 많다고 합니다. 참고해주세요.
s/서비스에 의해 대상으로 선정된/서비스가 대상으로 하는/

<h3>요약y</h3>
<ul>
<li>파드들을 외부 트래픽에 노출하기</li>
<li>여러 파드들 사이로 트래픽 로드밸런싱 하기</li>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

의견입니다. 참고해주세요.
s/여러 파드들 사이로/여러 파드에 걸쳐서/


<div class="row">
<div class="col-md-8">
<p>서비스는 파드세트들 사이에서 트래픽을 라우트한다. 여러분의 애플리케이션에 영향을 주지 않으면서 쿠버네티스에서 파드들이 죽게도 하고, 복제가 되게도 해주는 추상적 개념이다. 독립적인 파드들 사이에서의 디스커버리와 라우팅은 (하나의 애플리케이션에서 프로트엔드와 백엔드 컴포넌트와 같은) 쿠버네티스 서비스들에 의해 처리된다.</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"across"를 "사이에서"로 옮기는 것 보다 "~에 걸쳐서"로 옮기는게 더 자연스러울 것 같습니다. 참고해주세요.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"독립적인"은 원문 내용과 반대의 의미입니다.

<div class="row">
<div class="col-md-8">
<p>서비스는 파드세트들 사이에서 트래픽을 라우트한다. 여러분의 애플리케이션에 영향을 주지 않으면서 쿠버네티스에서 파드들이 죽게도 하고, 복제가 되게도 해주는 추상적 개념이다. 독립적인 파드들 사이에서의 디스커버리와 라우팅은 (하나의 애플리케이션에서 프로트엔드와 백엔드 컴포넌트와 같은) 쿠버네티스 서비스들에 의해 처리된다.</p>
<p>서비스는 쿠버네티스의 객체들에 대해 논리적 운영을 허용해주는 원시적인 하나의 그룹핑인, <a href="/docs/concepts/overview/working-with-objects/labels">labels and selectors</a>를 이용하여 파드세트들과 매치시킨다. 레이블들은 오브젝트들에 붙여진 키/밸류 쌍으로 다양한 방식으로 이용가능 하다:</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"labels and selectors" 번역해주세요.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

레이블은 운영의 대상이 아니라 연산의 대상입니다.
s/논리적 운영/논리 연산/

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/객체/오브젝트/ by 용어집

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

동사 "가능하다"의 활용입니다. 띄어쓰기 맞춰주세요.
s/이용가능 하다/이용 가능하다/

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

원문의 Primitive는 명사로 활용됐습니다. 수정해주세요.

s/원시적인 하나의 그룹핑인/그룹핑 프리미티브인/
또는
s/원시적인 하나의 그룹핑인/기본 그룹핑 단위인/
를 제안드립니다.

<br>
<div class="row">
<div class="col-md-12">
<a class="btn btn-lg btn-success" href="/docs/tutorials/kubernetes-basics/expose-interactive/" role="button">대화형 강좌 시작<span class="btn__next">›</span></a>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

문서 내 일관성 맞춰주세요.
s/강좌/튜토리얼/

<br>
<div class="row">
<div class="col-md-8">
<p>레이블들은 생성 시점 또는 이후 시점에 붙여질 수 있다. 언제든지 수정이 가능하다. 이제 서비스를 이용하여 우리의 애플리케이션을 노출도 시켜보고 레이블들도 적용해 보자.</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

원문의 object가 누락되었습니다.
s/생성 시점/오브젝트의 생성 시점/

@zer0big
Copy link
Contributor Author

zer0big commented Aug 31, 2018

@gochist 리뷰 감사드립니다~ 리뷰주신 사항 반영하도록 하겠습니다.

@zer0big
Copy link
Contributor Author

zer0big commented Sep 1, 2018

@gochist 리뷰해주신 내용 너무 감사드리고 모두 반영했습니다. 다만 개행관련 부분은 제가 정확하게 이해를 못해 패스했습니다.

Copy link
Contributor

@gochist gochist left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

빠른 수정 감사드립니다! 일부 리뷰 결과 반영이 누락된 내용이 있습니다. 추가 변경 요청 사항도 있습니다.

개행 관련 내용은 원문에 강제 개행이 있는 것으로 제가 착각했습니다. 무시해주세요. ( #11 에서 실수 또는 의도적으로 강제 개행이 추가된 것 같습니다. )

<div class="col-md-8">
<h3>쿠버네티스 서비스들에 대한 개요</h3>

<p>쿠버네티스 <a href="/docs/concepts/workloads/pods/pod-overview/">파드들</a> 은 언젠가는 죽게된다. 실제 파드들은 <a href="/docs/concepts/workloads/pods/pod-lifecycle/">생명주기</a>를 갖는다. 워커 노드가 죽으면, 노드 상에서 동작하는 파드들 또한 종료된다. A <a href="/docs/user-guide/replication-controller/#what-is-a-replicationcontroller">레플리케이션 컨트롤러</a>는 여러분의 애플리케이션이 지속적으로 동작할 수 있도록 새로운 파드들의 생성을 통해 동적으로 클러스터를 미리 지정해 둔 상태로 되돌려 줄 수도 있다. 또 다른 예시로서, 3개의 복제본을 갖는 이미지 처리용 백엔드를 고려해 보자. 그 복제본들은 대체 가능한 상태이다. 그래서 프론트엔드 시스템은 하나의 파드가 소멸되어 재생성이 되더라도, 백엔드 복제본들에 의한 영향을 받아서는 안된다. 즉, 동일 노드 상의 파드들이라 할지라도, 쿠버네티스 클러스터 내 각 파드는 유일한 IP 주소를 가지며, 여러분의 애플리케이션들이 지속적으로 기능할 수 있도록 파드들 속에서 발생하는 변화에 대해 자동으로 조정해 줄 방법이 있어야 한다.</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/A 레플리케이션/레플리케이션/

<p>비록 각 파드들이 고유의 IP를 갖고 있기는 하지만, 그 IP들은 서비스의 도움없이 클러스터 외부로 노출되어질 수 없다. 서비스들은 여러분의 애플리케이션들에게 트래픽이 실릴 수 있도록 허용해준다. 서비스들은 ServiceSpec 에서 <code>type</code>을 지정함으로써 다양한 방식들로 노출시킬 수 있다:</p>
<ul>
<li><i>ClusterIP</i> (기본값) - 클러스터 내에서 내부 IP 에 대해 서비스를 노출해준다. 이 방식은 오직 클러스터 내에서만 서비스가 접근될 수 있도록 해준다.</li>
<li><i>NodePort</i> - NAT가 이용되는 클러스터 내에서 각각 선택된 Node들의 동일한 포트에 서비스를 노출시켜준다. <code>&lt;NodeIP&gt;:&lt;NodePort&gt;</code>를 이용하여 클러스터 외부로부터 서비스가 접근가능토록 해준다. CluserIP의 상위집합 이다.</li>
Copy link
Contributor

@gochist gochist Sep 1, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

이 문단의 리뷰 반영이 누락되었습니다.

용어집 기준 s/Node/노드/
띄어쓰기 s/상위집합 이다/상위 집합이다/

<ul>
<li><i>ClusterIP</i> (기본값) - 클러스터 내에서 내부 IP 에 대해 서비스를 노출해준다. 이 방식은 오직 클러스터 내에서만 서비스가 접근될 수 있도록 해준다.</li>
<li><i>NodePort</i> - NAT가 이용되는 클러스터 내에서 각각 선택된 Node들의 동일한 포트에 서비스를 노출시켜준다. <code>&lt;NodeIP&gt;:&lt;NodePort&gt;</code>를 이용하여 클러스터 외부로부터 서비스가 접근가능토록 해준다. CluserIP의 상위집합 이다.</li>
<li><i>LoadBalancer</i> - (지원 가능한 경우) 기존 클라우드에서 외부용 로드밸런서를 생성하고 서비스에 고정된 공인 IP를 할당해준다. NodePort의 상위집합 이다. </li>
Copy link
Contributor

@gochist gochist Sep 1, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

이 문단도 리뷰 반영이 누락되었습니다.

띄어쓰기 s/상위집합 이다/상위 집합이다/

<li><i>ClusterIP</i> (기본값) - 클러스터 내에서 내부 IP 에 대해 서비스를 노출해준다. 이 방식은 오직 클러스터 내에서만 서비스가 접근될 수 있도록 해준다.</li>
<li><i>NodePort</i> - NAT가 이용되는 클러스터 내에서 각각 선택된 Node들의 동일한 포트에 서비스를 노출시켜준다. <code>&lt;NodeIP&gt;:&lt;NodePort&gt;</code>를 이용하여 클러스터 외부로부터 서비스가 접근가능토록 해준다. CluserIP의 상위집합 이다.</li>
<li><i>LoadBalancer</i> - (지원 가능한 경우) 기존 클라우드에서 외부용 로드밸런서를 생성하고 서비스에 고정된 공인 IP를 할당해준다. NodePort의 상위집합 이다. </li>
<li><i>ExternalName</i> - 이름으로 CNAME 레코드를 반환함으로써 임의의 이름(스펙에서 <code>externalName</code>으로 명시)을 이용하여 서비스를 노출시켜준다. 프록시는 사용되지 않는다. 이 방식은 code>kube-dns</code> 버전 1.7 이상에서 지원 가능하다.</li>
Copy link
Contributor

@gochist gochist Sep 1, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

이 방식은 code>kube-dns

"<" 이 누락되어 페이지 렌더링시 마크업 태그가 노출됩니다.

<div class="row">
<div class="col-md-8">
<p>서비스는 파드 세트에 걸쳐서 트래픽을 라우트한다. 여러분의 애플리케이션에 영향을 주지 않으면서 쿠버네티스에서 파드들이 죽게도 하고, 복제가 되게도 해주는 추상적 개념이다. 종속적인 파드들 사이에서의 디스커버리와 라우팅은 (하나의 애플리케이션에서 프로트엔드와 백엔드 컴포넌트와 같은) 쿠버네티스 서비스들에 의해 처리된다.</p>
<p>서비스는 쿠버네티스의 객체들에 대해 논리 연산을 허용해주는 기본 그룹핑 단위인, <a href="/docs/concepts/overview/working-with-objects/labels">레이블과 셀렉터s</a>를 이용하여 파드 세트와 매치시킨다. 레이블들은 오브젝트들에 붙여진 키/밸류 쌍으로 다양한 방식으로 이용 가능하다:</p>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/셀렉터s/셀렉터/

@zer0big
Copy link
Contributor Author

zer0big commented Sep 1, 2018

@gochist 리뷰해주신 내용 너무 감사드리고, 자체적으로 재리뷰한 결과 반영 하였습니다~(다시 보니 그래도 수정사항이 보이더군요^^)

@k8s-ci-robot
Copy link

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by:

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@k8s-ci-robot k8s-ci-robot added approved Indicates a PR has been approved by an approver from all required OWNERS files. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files. and removed size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Sep 1, 2018
@gochist
Copy link
Contributor

gochist commented Sep 1, 2018

@zer0big 죄송합니다. 제가 조작을 잘못해서 PR이 close 되었는데, 곧 조치하겠습니다.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
approved Indicates a PR has been approved by an approver from all required OWNERS files. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. size/XS Denotes a PR that changes 0-9 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants