쿠버네티스 문서에 기여하기

Edit This Page

쿠버네티스 문서 한글화 가이드

쿠버네티스 문서 한글화를 위한 가이드

문체 가이드

높임말

평어체 사용을 원칙으로 하나, 일부 페이지(예: https://kubernetes.io/ko)에 한해 예외적으로 높임말을 사용한다.

명령형

어떤 일을 하도록 청자에게 요구하는 명령형 표현은 간결하고 부드러운 표현으로 정확한 의미를 전달하기 위해 어떤 일을 함께 하기를 요청하는 청유형 또는 객관적으로 진술하는 평어체로 번역한다.

명령형 문장번역체
사이트를 방문하라사이트를 방문하자 (청유형)
가이드를 참고하라가이드를 참고한다 (평어체)

번역체 지양

우리글로서 자연스럽고 무리가 없도록 번역한다.

번역체자연스러운 문장
-되어지다 (이중 피동 표현)-되다
짧은 다리를 가진 돼지다리가 짧은 돼지
그는 그의 손으로 숟가락을 들어 그의 밥을 먹었다그는 손으로 숟가락을 들어 밥을 먹었다
접시를 씻고설거지를 하고
가게에 배들, 사과들, 복숭아들이 있다 (과다한 복수형)가게에 배, 사과, 복숭아들이 있다

문서 코딩 가이드

가로폭은 원문을 따름

유지보수의 편의를 위해서 원문의 가로폭을 따른다.

즉, 원문이 한 문단을 줄바꿈하지 않고 한 행에 길게 기술했다면 한글화 시에도 한 행에 길게 기술하고, 원문이 한 문단을 줄바꿈해서 여러 행으로 기술한 경우에는 한글화 시에도 가로폭을 원문과 비슷하게 유지한다.

리뷰어 삭제

때때로 원문의 코드 상단에 리뷰어가 명시되어 있는 경우가 있다. 일반적으로 원문 페이지의 리뷰어가 한글화 된 페이지를 리뷰하기 어려우므로 리소스 메타데이터에서 리뷰어 관련 코드를 삭제한다.

아래는 리뷰어 관련 코드를 삭제하는 예시를 보여준다.

- reviews:
- - reviewer1
- - reviewer
- title: Kubernetes Components
+
+
+
+ title: 쿠버네티스 컴포넌트
content_template: templates/concept
weight: 10

용어 한글화 가이드

용어 한글화의 일반적 방침

영문 용어를 한글화할 때는 다음의 우선 순위를 따르나, 자연스럽지 않은 용어를 무리하게 선택하지는 않는다.

  • 한글 단어
    • 순 우리말 단어
    • 한자어 (예: 운영 체제), 외래어 (예: 쿠버네티스, 파드)
  • 한영 병기 (예: 훅(hook))
  • 영어 단어 (예: Kubelet)

단, 자연스러움을 판단하는 기준은 주관적이므로 한글화 용어집을 준용하고 기존에 번역된 문서를 참고한다.

참고: 한영 병기는 페이지 내에서 해당 용어가 처음 사용되는 경우에만 적용하고 이후 부터는 한글만 표기한다.

API 오브젝트 용어 한글화 관련 방침

API 오브젝트는 외래어 표기법에 따라 한글 표기한다.

쿠버네티스 API 오브젝트는 원 단어를 국립국어원 외래어 표기법에 따라 한글화 한다. 예를 들면 다음과 같다.

원 단어외래어 표기
Deployment디플로이먼트
Pod파드
Service서비스
참고: 단, API 오브젝트 한글화 원칙에 예외가 있을 수 있으며, 이 경우에는 가능한 한글화 용어집을 준용한다. (예를 들면, Horizontal Pod Autoscaler 는 API 오브젝트에 대해 외래어 표기법 적용하지 않고 원문 그대로 표기한다.)
참고: API 오브젝트의 필드 이름, 파일 이름, 경로와 같은 내용은 독자가 구성 파일이나 커맨드라인에서 그대로 사용할 가능성이 높으므로 한글로 옮기지 않고 원문을 유지한다. 단, 주석에 포함된 내용은 한글로 옮길 수 있다.

한글화 용어집 정보

쿠버네티스 한글화 용어집은 한글화된 쿠버네티스 문서의 일관성을 위해서 각 영문 용어에 대한 한글화 방법을 제시한다. 한글화 용어집에 포함된 용어는 쿠버네티스 문서 한글화팀 회의를 통해 결정되었으며, 본 문서에 대한 ISSUE 및 PR을 통해서 개선한다.

한글화 용어집 개선 가이드

한글화 용어집의 개선(추가, 수정, 삭제 등)을 위한 과정은 다음과 같다.

  1. 컨트리뷰터가 개선이 필요한 용어을 파악하면, ISSUE를 생성하여 개선 필요성을 공유하거나 master 브랜치에 PR을 생성하여 개선된 용어를 제안한다.

  2. 개선 제안에 대한 논의는 ISSUE 및 PR을 통해서 이루어지며, 한글화팀 회의를 통해 확정한다.

  3. 리뷰어 및 승인자는 작업 중인 한글화 작업 브랜치(예: dev-1.17-ko.3)에 영향을 최소화 하기 위해서, 신규 한글화 작업 브랜치(예: dev-1.17-ko.4) 생성 시점에 맞춰 확정된 PR을 승인한다. 개선된 한글화 용어집은 신규 한글화 작업 브랜치부터 적용한다.

  4. 개선된 한글화 용어집에 따라 기존의 한글 문서에 대한 업데이트가 필요하며, 컨트리뷰션을 통해서 업데이트를 진행한다.

한글화 용어집

English한글비고
Access접근
ActiveActive잡의 상태
Active Job액티브 잡
Addons애드온
admission controller어드미션 컨트롤러
Age기간
Allocation할당량
alphanumeric영숫자
Annotation어노테이션
App
Appendix부록
Application애플리케이션
ArgsArgs약어의 형태이므로 한글화하지 않고 영문 표기
array배열
autoscaler오토스케일러
availability zone가용성 영역(availability zone)
bare pod베어(bare) 파드
beta베타
boilerplate상용구
Boot부트
Build빌드
Cache캐시
canary카나리(canary)릴리스 방식에 관련한 용어인 경우에 한함
cascading캐스케이딩(cascading)
character set캐릭터 셋
Charts차트
checkpoint체크포인트
CLICLI
Cluster클러스터
Command Line Tool커맨드라인 툴
Config Map컨피그 맵
configuration구성, 설정
Connection연결
containerized컨테이너화 된
Context컨텍스트
Control Plane컨트롤 플레인
controller컨트롤러
Cron Job크론 잡
custom metrics사용자 정의 메트릭
Custom resource사용자 정의 리소스
CustomResourceDefinition커스텀 리소스 데피니션
Daemon데몬
Daemon Set데몬 셋
Dashboard대시보드
Data Plane데이터 플레인
Default Limit기본 상한
Default Request기본 요청량
Deployment디플로이먼트
deprecated사용 중단(deprecated)
descriptor디스크립터, 식별자
Desired number of pods의도한 파드의 수
Desired State의도한 상태
disruption중단(disruption)
distros배포판
Docker도커
DockerfileDockerfile
Downward API다운워드(Downward) API
draining드레이닝(draining)
egress이그레스, 송신(egress)
Endpoint엔드포인트
entry point진입점
Event이벤트
ExecExec
expose노출시키다
extension익스텐션(extension)
FailedFailed파드의 상태에 한함
Federation페더레이션
field필드
FlannelFlannel
form형식
Google Compute EngineGoogle Compute Engine
hash해시
headless헤드리스
health check헬스 체크
Heapster힙스터(Heapster)
Heartbeat하트비트
HomebrewHomebrew
hook훅(hook)
Horizontal Pod AutoscalerHorizontal Pod Autoscaler예외적으로 API 오브젝트에 대해 외래어 표기법 적용하지 않고 원문 그대로 표기
hosted zone호스팅 영역
hostname호스트네임
Huge pageHuge page
Hypervisor하이퍼바이저
idempotent멱등성
Image이미지
Image Pull Secrets이미지 풀(Pull) 시크릿
Ingress인그레스
Init Container초기화 컨테이너
Instance group인스턴스 그룹
introspection인트로스펙션(introspection)
Istio이스티오(Istio)
Job
kube-proxykube-proxy
KubeletKubelet
Kubernetes쿠버네티스
label레이블
lifecycle라이프사이클
Linux리눅스
load부하
Log로그
loopback루프백(loopback)
LostLost클레임의 상태에 한함
Machine머신
manifest매니페스트
Master마스터
max limit/request ratio최대 상한/요청량 비율
metadata메타데이터
metric메트릭
masquerading마스커레이딩
MinikubeMinikube
Mirror pod미러 파드(mirror pod)
monitoring모니터링
multihomed멀티홈드(multihomed)
naked pod네이키드(naked) 파드
Namespace네임스페이스
netfilter넷필터(netfilter)
Network Policy네트워크 폴리시
Node노드
node lease노드 리스(lease)
Object오브젝트
Orchestrate오케스트레이션하다
Output출력
parameter파라미터
patch패치
PendingPending파드, 클레임의 상태에 한함
Persistent Volume퍼시스턴트 볼륨
Persistent Volume Claim퍼시스턴트 볼륨 클레임
pipeline파이프라인
placeholder pod플레이스홀더(placeholder) 파드
Pod(파드)파드
Pod Preset파드 프리셋
PodAntiAffinity파드안티어피니티(PodAntiAffinity)
PodDisruptionBudgetPodDisruptionBudget
postfix접미사
prefix접두사
Privileged특권을 가진(privileged)
Prometheus프로메테우스
proof of concept개념 증명
Pull Request풀 리퀘스트
Pull Secret Credentials풀(Pull) 시크릿 자격증명
QoS ClassQoS 클래스
Quota쿼터
readiness gate준비성 게이트(readiness gate)
readiness probe준비성 프로브(readiness probe)
ReadyReady
Reclaim Policy반환 정책
redirect리다이렉트(redirect)
redirection리다이렉션
Registry레지스트리
Release릴리스
Replica Set레플리카 셋
replicas레플리카
Replication Controller레플리케이션 컨트롤러
repository리포지터리
resource리소스
Resource Limit리소스 상한
Resource Quota리소스 쿼터
return반환하다
revision리비전
Role
rollback롤백
rolling update롤링 업데이트
rollout롤아웃
RunningRunning파드의 상태에 한함
runtime런타임
Scale스케일
Secret시크릿
segment세그먼트
Selector셀렉터
Self-healing자가 치유
Service서비스
Service Account서비스 어카운트
service discovery서비스 디스커버리
service mesh서비스 메시
Session세션
Session Affinity세션 어피니티(Affinity)
Setting세팅
Shell
Sign In로그인
Sign Out로그아웃
skew차이(skew)
spec명세, 스펙, 사양
specification명세
Stateful Set스테이트풀 셋
stateless스테이트리스
Static pod스태틱(static) 파드
Storage Class스토리지 클래스
Sub-Object서브-오브젝트
support지원
Surge증가율롤링업데이트 전략에 한함
System시스템
taint테인트(taint)
Task태스크
TerminatedTerminated파드의 상태에 한함
tolerations톨러레이션(toleration)
Topology spread constraints토폴로지 분배 제약 조건
Tools도구
traffic트래픽
Type타입
ubuntu우분투
use case유스케이스
userspace유저스페이스(userspace)
Utilization사용량, 사용률
verbosity로그 상세 레벨(verbosity)
virtualization가상화
Volume볼륨
WaitingWaiting파드의 상태에 한함
Walkthrough연습
Windows윈도우
Worker워커노드의 형태에 한함
Workload워크로드
YAMLYAML

피드백