처음하는 사람들을 위한 OSSCA k8s 에 한글화 작업 기여하기

1. github 중에서 kubernetes/website 로 들어가서 fork 떠오기

kubernetes/website: Kubernetes website and documentation repo: (github.com)

GitHub - kubernetes/website: Kubernetes website and documentation repo:

위의 링크로 가면 k8s의 웹사이트 소스코드를 모두 볼 수 있다. 이 사이트로 가서 

 

한국어 번역팀이 참가중인 dev-1.24-ko.3 최신 버전 브랜치로 이동해주자

 

이 것을 fork 떠온다.

 

 

이때 중요한 것은 Copy the main  branch only 옵션은 꺼주자

 

 

여기까지 되었다면 해당 깃헙 정보를 clone 하기 위해 주소를 복사해주자

 

 

2. Clone 해오기

 

git이 설치되었다면 상관없는데 만약 없다면 다음 사이트에서 미리 다운 받아놓자

Git (git-scm.com)

Git

아무튼 원하는 폴더 우 클릭을 하고 Git Bash here 을 클릭하여 bash console을 띄워주자

 

여기에다가

git clone https://github.com/tonyhan18/website.git

식으로 저장소를 clone 해주자

 

clone 이 엄청 오래걸릴 것이다. 그 사이에 vscode 를 다운받아놓자

Visual Studio Code - Code Editing. Redefined

Visual Studio Code - Code Editing. Redefined

암튼 설치해주자

 

그 사이에 git이 모두 다운 받아졌다. 여기까지 되었다면 vscode 로 화면을 켜주자

 

git bash 에

```

cd website

code .

```

해주면 윈도우인 경우 자동으로 vscode 창이 나온다. 맥은 특수한 설정을 또 해주어야 한다.

 

3. 업데이트 확인과 브런치 옮기기

 

다 되었다면 vscode 아래쪽의 Terminal 부분에서 Git Bash 부분으로 바꾸어 준다.

이유는 이렇게 해서 리눅스 명령어 처럼 사용이 가능해져서 이다.

main, dev-1.24-ko.3 모두 최신 상태로 만든다음 우리의 브런치를 따주자

 

나는 eviction을 다시 작업할거다

 

```

git checkout -b 220812_ko_Translate_the_glossary_term_Eviction

```

 

 

4. 번역하고 업로드하기

https://kubernetes.io/ko/docs/reference/glossary/?all=true

용어집

d

이제 k8s 사이트에서 내가 번역할 부분을 찾아내자

 

참고로 나는 Eviction을 맡았다.

대충 보아도 번역 안된 문서...

 

content > en > docs > reference > glossary > eviction.md 로 가보면 우리가 번역해야하는 것이 있다. 이걸 번역해주자

 

해당 마크다운 파일을 복사해서

content > ko > docs > reference > glossary 아래에 eviction.md 라는 파일명으로 복붙해주자

 

파일의 위치가 보이는가? 이런식으로 해주면 된다. 이 상태에서 파일을 수정해주자

위와같이 위 아래로 나누어서 위쪽에 영어 아래쪽에 한국어를 놓고 작업해주면 편하다.

 

 

번역이 완료되었다 이제 이걸 업로드 해주자

 

```

git add .

git commit -m "[ko] translate the glossary term eviction"

git push origin 220812_ko_Translate_the_glossary_term_Evection

```

의 브런치로 업로드 되었다. 이제 이걸 github에 가서 pull request(PR) 던지면 된다.

 

 

5. origin repo로 PR 던지기

origin repo > Pull requests 로 가보면 내가 push 한 브런치가 보인다. 이걸 토대로 pull request 를 요청하면 된다. 바로 보이는 오른쪽 아래의 'Compare & pull request' 를 누르자

 

그럼 자연스럽게 위와같은 창이 나오니까 이제 제목만 있음직하게, commit 했던 것 처럼

`[ko] translate the glossary term eviction`

로 적어서 Create pull request 를 던지자

 

그러면 k8s bot이 돌게되는데

 

가끔 CLA 승인이 안되는 경우가 있다.

이건 사실 별게 아닌게 그냥

1. 개인 서류 작성 안했거나

2. github 에 올릴때

git config --global user.name "John Doe"

의 부분을 CLA 와 동일하게 하지 않아서 생기는 오류이다.

 

해당 에러를 해결하기 위해 먼저 위 오류문의 'Please click here to be authorized' 부분을 클릭해서 사이트에 들어가고

개인 서류를 작성해주면 에러가 없어진다.