Merge pull request #30277 from seokho-son/out1.22ko-m39
[ko] Update contribute new-content of 1.22-ko.2pull/30381/head
commit
65ee4acae8
|
@ -1,4 +1,64 @@
|
||||||
---
|
---
|
||||||
title: 새로운 콘텐츠 기여하기
|
title: 새로운 콘텐츠 기여하기
|
||||||
|
content_type: concept
|
||||||
|
main_menu: true
|
||||||
weight: 20
|
weight: 20
|
||||||
---
|
---
|
||||||
|
|
||||||
|
<!-- overview -->
|
||||||
|
|
||||||
|
이 섹션에는 새로운 콘텐츠를 기여하기 전에 알아야 할 정보가 있다.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<!-- body -->
|
||||||
|
|
||||||
|
## 기여에 대한 기본 사항
|
||||||
|
|
||||||
|
- 마크다운(Markdown)으로 쿠버네티스 문서를 작성하고 [Hugo](https://gohugo.io/)를 사용하여 쿠버네티스 사이트를 구축한다.
|
||||||
|
- 소스는 [GitHub](https://github.com/kubernetes/website)에 있다. 쿠버네티스 문서는 `/content/ko/docs/` 에서 찾을 수 있다. 일부 참조 문서는 `update-imported-docs/` 디렉터리의 스크립트에서 자동으로 생성된다.
|
||||||
|
- [페이지 템플릿](/docs/contribute/style/page-content-types/)은 Hugo에서 문서 콘텐츠의 프리젠테이션을 제어한다.
|
||||||
|
- 표준 Hugo 단축코드(shortcode) 이외에도 설명서에서 여러
|
||||||
|
[사용자 정의 Hugo 단축코드](/docs/contribute/style/hugo-shortcodes/)를 사용하여 콘텐츠 표시를 제어한다.
|
||||||
|
- 문서 소스는 `/content/` 에서 여러 언어로 제공된다. 각
|
||||||
|
언어는 [ISO 639-1 표준](https://www.loc.gov/standards/iso639-2/php/code_list.php)에
|
||||||
|
의해 결정된 2문자 코드가 있는 자체 폴더가 있다. 예를 들어,
|
||||||
|
한글 문서의 소스는 `/content/ko/docs/` 에 저장된다.
|
||||||
|
- 여러 언어로 문서화에 기여하거나 새로운 번역을 시작하는 방법에 대한 자세한 내용은 [현지화](/ko/docs/contribute/localization_ko/)를 참고한다.
|
||||||
|
|
||||||
|
## 시작하기 전에 {#before-you-begin}
|
||||||
|
|
||||||
|
### CNCF CLA 서명 {#sign-the-cla}
|
||||||
|
|
||||||
|
모든 쿠버네티스 기여자는 **반드시** [기여자 가이드](https://github.com/kubernetes/community/blob/master/contributors/guide/README.md)를 읽고 [기여자 라이선스 계약(CLA)에 서명](https://github.com/kubernetes/community/blob/master/CLA.md)해야 한다.
|
||||||
|
|
||||||
|
CLA에 서명하지 않은 기여자의 풀 리퀘스트(pull request)는 자동 테스트에 실패한다. 제공한 이름과 이메일은 `git config` 에 있는 것과 일치해야 하며, git 이름과 이메일은 CNCF CLA에 사용된 것과 일치해야 한다.
|
||||||
|
|
||||||
|
### 사용할 Git 브랜치를 선택한다
|
||||||
|
|
||||||
|
풀 리퀘스트를 열 때는, 작업의 기반이 되는 브랜치를 미리 알아야 한다.
|
||||||
|
|
||||||
|
시나리오 | 브랜치
|
||||||
|
:---------|:------------
|
||||||
|
현재 릴리스의 기존 또는 새로운 영어 콘텐츠 | `main`
|
||||||
|
기능 변경 릴리스의 콘텐츠 | `dev-<version>` 패턴을 사용하여 기능 변경이 있는 주 버전과 부 버전에 해당하는 브랜치. 예를 들어, `v{{< skew nextMinorVersion >}}` 에서 기능이 변경된 경우, ``dev-{{< skew nextMinorVersion >}}`` 에 문서 변경을 추가한다.
|
||||||
|
다른 언어로된 콘텐츠(현지화) | 현지화 규칙을 사용. 자세한 내용은 [현지화 브랜치 전략](/docs/contribute/localization/#branching-strategy)을 참고한다.
|
||||||
|
|
||||||
|
|
||||||
|
어떤 브랜치를 선택해야 할지 잘 모르는 경우 슬랙의 `#sig-docs` 에 문의한다.
|
||||||
|
|
||||||
|
{{< note >}}
|
||||||
|
풀 리퀘스트를 이미 제출했는데 기본 브랜치가 잘못되었다는 것을 알게 되면,
|
||||||
|
제출자(제출자인 여러분만)가 이를 변경할 수 있다.
|
||||||
|
{{< /note >}}
|
||||||
|
|
||||||
|
### PR 당 언어
|
||||||
|
|
||||||
|
PR 당 하나의 언어로 풀 리퀘스트를 제한한다. 여러 언어로 동일한 코드 샘플을 동일하게 변경해야 하는 경우 각 언어마다 별도의 PR을 연다.
|
||||||
|
|
||||||
|
## 기여자를 위한 도구들
|
||||||
|
|
||||||
|
`kubernetes/website` 리포지터리의 [문서 기여자를 위한 도구](https://github.com/kubernetes/website/tree/main/content/en/docs/doc-contributor-tools) 디렉터리에는 기여 여정을 좀 더 순조롭게 도와주는 도구들이 포함되어 있다.
|
||||||
|
|
||||||
|
|
||||||
|
|
|
@ -1,65 +0,0 @@
|
||||||
---
|
|
||||||
title: 새로운 콘텐츠 기여하기에 대한 개요
|
|
||||||
linktitle: 개요
|
|
||||||
content_type: concept
|
|
||||||
main_menu: true
|
|
||||||
weight: 5
|
|
||||||
---
|
|
||||||
|
|
||||||
<!-- overview -->
|
|
||||||
|
|
||||||
이 섹션에는 새로운 콘텐츠를 기여하기 전에 알아야 할 정보가 있다.
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<!-- body -->
|
|
||||||
|
|
||||||
## 기여하기에 대한 기본
|
|
||||||
|
|
||||||
- 마크다운(Markdown)으로 쿠버네티스 문서를 작성하고 [Hugo](https://gohugo.io/)를 사용하여 쿠버네티스 사이트를 구축한다.
|
|
||||||
- 소스는 [GitHub](https://github.com/kubernetes/website)에 있다. 쿠버네티스 문서는 `/content/ko/docs/` 에서 찾을 수 있다. 일부 참조 문서는 `update-imported-docs/` 디렉터리의 스크립트에서 자동으로 생성된다.
|
|
||||||
- [페이지 템플릿](/docs/contribute/style/page-content-types/)은 Hugo에서 문서 콘텐츠의 프리젠테이션을 제어한다.
|
|
||||||
- 표준 Hugo 단축코드(shortcode) 이외에도 설명서에서 여러
|
|
||||||
[사용자 정의 Hugo 단축코드](/docs/contribute/style/hugo-shortcodes/)를 사용하여 콘텐츠 표시를 제어한다.
|
|
||||||
- 문서 소스는 `/content/` 에서 여러 언어로 제공된다. 각
|
|
||||||
언어는 [ISO 639-1 표준](https://www.loc.gov/standards/iso639-2/php/code_list.php)에
|
|
||||||
의해 결정된 2문자 코드가 있는 자체 폴더가 있다. 예를 들어,
|
|
||||||
한글 문서의 소스는 `/content/ko/docs/` 에 저장된다.
|
|
||||||
- 여러 언어로 문서화에 기여하거나 새로운 번역을 시작하는 방법에 대한 자세한 내용은 [현지화](/ko/docs/contribute/localization_ko/)를 참고한다.
|
|
||||||
|
|
||||||
## 시작하기 전에 {#before-you-begin}
|
|
||||||
|
|
||||||
### CNCF CLA 서명 {#sign-the-cla}
|
|
||||||
|
|
||||||
모든 쿠버네티스 기여자는 **반드시** [기여자 가이드](https://github.com/kubernetes/community/blob/master/contributors/guide/README.md)를 읽고 [기여자 라이선스 계약(CLA)에 서명](https://github.com/kubernetes/community/blob/master/CLA.md)해야 한다.
|
|
||||||
|
|
||||||
CLA에 서명하지 않은 기여자의 풀 리퀘스트(pull request)는 자동 테스트에 실패한다. 제공한 이름과 이메일은 `git config` 에 있는 것과 일치해야 하며, git 이름과 이메일은 CNCF CLA에 사용된 것과 일치해야 한다.
|
|
||||||
|
|
||||||
### 사용할 Git 브랜치를 선택한다
|
|
||||||
|
|
||||||
풀 리퀘스트를 열 때는, 작업의 기반이 되는 브랜치를 미리 알아야 한다.
|
|
||||||
|
|
||||||
시나리오 | 브랜치
|
|
||||||
:---------|:------------
|
|
||||||
현재 릴리스의 기존 또는 새로운 영어 콘텐츠 | `main`
|
|
||||||
기능 변경 릴리스의 콘텐츠 | `dev-<version>` 패턴을 사용하여 기능 변경이 있는 주 버전과 부 버전에 해당하는 브랜치. 예를 들어, `v{{< skew nextMinorVersion >}}` 에서 기능이 변경된 경우, ``dev-{{< skew nextMinorVersion >}}`` 에 문서 변경을 추가한다.
|
|
||||||
다른 언어로된 콘텐츠(현지화) | 현지화 규칙을 사용. 자세한 내용은 [현지화 브랜치 전략](/docs/contribute/localization/#branching-strategy)을 참고한다.
|
|
||||||
|
|
||||||
|
|
||||||
어떤 브랜치를 선택해야 할지 잘 모르는 경우 슬랙의 `#sig-docs` 에 문의한다.
|
|
||||||
|
|
||||||
{{< note >}}
|
|
||||||
풀 리퀘스트를 이미 제출했는데 기본 브랜치가 잘못되었다는 것을 알게 되면,
|
|
||||||
제출자(제출자인 여러분만)가 이를 변경할 수 있다.
|
|
||||||
{{< /note >}}
|
|
||||||
|
|
||||||
### PR 당 언어
|
|
||||||
|
|
||||||
PR 당 하나의 언어로 풀 리퀘스트를 제한한다. 여러 언어로 동일한 코드 샘플을 동일하게 변경해야 하는 경우 각 언어마다 별도의 PR을 연다.
|
|
||||||
|
|
||||||
## 기여자를 위한 도구들
|
|
||||||
|
|
||||||
`kubernetes/website` 리포지터리의 [문서 기여자를 위한 도구](https://github.com/kubernetes/website/tree/main/content/en/docs/doc-contributor-tools) 디렉터리에는 기여 여정이 좀 더 순조롭게 진행되도록 도와주는 도구들이 포함되어 있다.
|
|
||||||
|
|
||||||
|
|
|
@ -1,4 +1,6 @@
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|
||||||
title: 쿠버네티스 문서
|
title: 쿠버네티스 문서
|
||||||
noedit: true
|
noedit: true
|
||||||
cid: docsHome
|
cid: docsHome
|
||||||
|
@ -20,9 +22,9 @@ overview: >
|
||||||
쿠버네티스는 배포, 스케일링, 그리고 컨테이너화된 애플리케이션의 관리를 자동화 해주는 오픈 소스 컨테이너 오케스트레이션 엔진이다. 본 오픈 소스 프로젝트는 Cloud Native Computing Foundation(<a href="https://www.cncf.io/about">CNCF</a>)가 주관한다.
|
쿠버네티스는 배포, 스케일링, 그리고 컨테이너화된 애플리케이션의 관리를 자동화 해주는 오픈 소스 컨테이너 오케스트레이션 엔진이다. 본 오픈 소스 프로젝트는 Cloud Native Computing Foundation(<a href="https://www.cncf.io/about">CNCF</a>)가 주관한다.
|
||||||
cards:
|
cards:
|
||||||
- name: concepts
|
- name: concepts
|
||||||
title: "기초 이해하기"
|
title: "쿠버네티스 이해하기"
|
||||||
description: "쿠버네티스와 쿠버네티스의 기본 개념을 배운다."
|
description: "쿠버네티스와 쿠버네티스의 기본 개념을 배운다."
|
||||||
button: "개념 배우기"
|
button: "개념 살펴보기"
|
||||||
button_path: "/ko/docs/concepts"
|
button_path: "/ko/docs/concepts"
|
||||||
- name: tutorials
|
- name: tutorials
|
||||||
title: "쿠버네티스 사용해보기"
|
title: "쿠버네티스 사용해보기"
|
||||||
|
|
|
@ -64,6 +64,8 @@ TCP/UDP 스트림 포워딩이나 백-엔드 집합에 걸쳐서 라운드-로
|
||||||
* [kube-scheduler 정책](/ko/docs/reference/scheduling/policies)
|
* [kube-scheduler 정책](/ko/docs/reference/scheduling/policies)
|
||||||
* [kube-scheduler 프로파일](/ko/docs/reference/scheduling/config/#여러-프로파일)
|
* [kube-scheduler 프로파일](/ko/docs/reference/scheduling/config/#여러-프로파일)
|
||||||
|
|
||||||
|
* 컨트롤 플레인과 워커 노드에서 꼭 열어야 하는
|
||||||
|
[포트와 프로토콜](/docs/reference/ports-and-protocols/) 리스트
|
||||||
## API 설정
|
## API 설정
|
||||||
|
|
||||||
이 섹션은 쿠버네티스 구성요소 또는 도구를 환경설정하는 데에 사용되는
|
이 섹션은 쿠버네티스 구성요소 또는 도구를 환경설정하는 데에 사용되는
|
||||||
|
|
Loading…
Reference in New Issue