Skip to content

Conversation

spacedustz
Copy link

Description

Translate /docs/concepts/architecture/cgroups.md into Korean

Closes: #52476

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Sep 22, 2025
@k8s-ci-robot k8s-ci-robot added the area/localization General issues or PRs related to localization label Sep 22, 2025
@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign jihoon-seo for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found 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 language/ko Issues or PRs related to Korean language sig/docs Categorizes an issue or PR as relevant to SIG Docs. labels Sep 22, 2025
@k8s-ci-robot
Copy link
Contributor

Welcome @spacedustz!

It looks like this is your first PR to kubernetes/website 🎉. Please refer to our pull request process documentation to help your PR have a smooth ride to approval.

You will be prompted by a bot to use commands during the review process. Do not be afraid to follow the prompts! It is okay to experiment. Here is the bot commands documentation.

You can also check if kubernetes/website has its own contribution guidelines.

You may want to refer to our testing guide if you run into trouble with your tests not passing.

If you are having difficulty getting your pull request seen, please follow the recommended escalation practices. Also, for tips and tricks in the contribution process you may want to read the Kubernetes contributor cheat sheet. We want to make sure your contribution gets all the attention it needs!

Thank you, and welcome to Kubernetes. 😃

@k8s-ci-robot k8s-ci-robot added the size/L Denotes a PR that changes 100-499 lines, ignoring generated files. label Sep 22, 2025
Copy link

netlify bot commented Sep 22, 2025

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 88f4495
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/68d0ef1d371aaa00086e8b7b
😎 Deploy Preview https://deploy-preview-52481--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@wonyongg
Copy link
Member

/assign

Copy link
Member

@wonyongg wonyongg left a comment

Choose a reason for hiding this comment

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

@spacedustz

안녕하세요. 첫 기여 PR 올려주셔서 진심으로 감사드립니다.
처음이라 여러 어려움이 있으셨을 거라 생각합니다.
몇 가지 리뷰를 남겨두었으니 확인 부탁드립니다.

@@ -0,0 +1,131 @@
---
title: cgroup에 관해
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
title: cgroup에 관해
title: cgroup v2에 대하여

title: About cgroup v2

~에 관해는 뒤에 나오는 문장을 꾸며주는 느낌이 강하지 않나 싶습니다. 따라서 ~에 관하여가 적절하다고 생각합니다.
개인적으로는 ~에 관하여보다는 ~에 대하여가 제목으로 더 많이 접한 경험이 있어 cgroup v2에 대하여를 제안드려봅니다.

리눅스에서, {{< glossary_tooltip text="컨트롤 그룹" term_id="cgroup" >}}은
프로세스에 할당되는 자원을 제한한다.

{{< glossary_tooltip text="" term_id="kubelet" >}}과
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
{{< glossary_tooltip text="" term_id="kubelet" >}}과
{{< glossary_tooltip text="kubelet" term_id="kubelet" >}}과

위 부분은 Hugo의 단축 코드입니다.
내부의 text 파라미터는 문서 공개 시 글로 표시됨으로 번역을 하거나, 영문 그대로 두어야 합니다.
이번에는 kubelet이기 때문에 그대로 두었습니다.

Comment on lines +13 to +15
기본이 되는 컨테이너 런타임은 cgroup과 연동하여
[파드와 컨테이너를 위한 리소스 관리](/ko/docs/concepts/configuration/manage-resources-containers/)를 적용해야 하며,
이는 컨테이너화된 워크로드의 CPU/메모리 요청 및 제한을 포함한다.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
기본이 되는 컨테이너 런타임은 cgroup과 연동하여
[파드와 컨테이너를 위한 리소스 관리](/ko/docs/concepts/configuration/manage-resources-containers/) 적용해야 하며,
이는 컨테이너화된 워크로드의 CPU/메모리 요청 및 제한을 포함한다.
기반 컨테이너 런타임은 컨테이너화된 워크로드에 대한 CPU/메모리 요청 및 제한을 포함하는
[파드와 컨테이너를 위한 자원 관리](/ko/docs/concepts/configuration/manage-resources-containers/)
강제하기 위해 cgroup과 연동해야 한다.

한 문서 안에 동일한 단어는 일관성 있게 번역해야 합니다.
전체적으로 이 문서에서 resource는 자원으로 번역하는 것에 문제가 없다고 생각하여 자원으로 통일했습니다.
리소스 -> 자원

전체적으로는 자연스럽게 바꾸어 보았습니다.

{{< feature-state for_k8s_version="v1.25" state="stable" >}}

cgroup v2는 리눅스 cgroup API의 다음 버전이다. cgroup v2는 향상된
리소스 관리 기능을 갖춘 통합 제어 시스템을
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
리소스 관리 기능을 갖춘 통합 제어 시스템을
자원 관리 기능을 갖춘 통합 제어 시스템을


- API의 단일 통합 계층 구조 설계
- 컨테이너에 대한 더 안전한 서브트리 위임
- [커널 압력 정보(Pressure Stall Information)](https://www.kernel.org/doc/html/latest/accounting/psi.html)와 같은 새로운 기능
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- [커널 압력 정보(Pressure Stall Information)](https://www.kernel.org/doc/html/latest/accounting/psi.html) 같은 새로운 기능
- [Pressure Stall Information](https://www.kernel.org/doc/html/latest/accounting/psi.html) 같은 새로운 기능

Pressure Stall Information의 경우 한국어 번역이 불필요하다고 생각했습니다.

사용 중인 배포판이 cgroup v2를 사용하는지 확인하려면, 해당 배포판의
문서를 참조하거나 [리눅스 노드에서 cgroup 버전 확인하기](#check-cgroup-version)의 지침을 따른다.

또한 커널 cmdline 부트 파라미터를 수정하여 리눅스 배포판에서
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
또한 커널 cmdline 부트 파라미터를 수정하여 리눅스 배포판에서
또한 커널 cmdline 부트 인자를 수정하여 리눅스 배포판에서

argument -> 인자로 번역했습니다.

cgroup v2를 수동으로 활성화할 수 있다. 사용 중인 배포판이 GRUB을 사용하는 경우,
`/etc/default/grub` 파일의 `GRUB_CMDLINE_LINUX`에
`systemd.unified_cgroup_hierarchy=1`을 추가한 다음, `sudo update-grub`을 실행해야 한다. 그러나,
권장되는 방법은 cgroup v2를 기본적으로 활성화하는 배포판을 사용하는
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
권장되는 방법은 cgroup v2를 기본적으로 활성화하는 배포판을 사용하는
권장되는 접근 방법은 cgroup v2를 기본적으로 활성화하는 배포판을 사용하는

Comment on lines +93 to +95
cgroup v2로 전환할 때 사용자 경험에서 눈에 띄는 차이는 없어야 한다.
단, 사용자가 노드 또는 컨테이너 내부에서 cgroup 파일 시스템에 직접
접근하는 경우는 예외이다.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
cgroup v2로 전환할 때 사용자 경험에서 눈에 띄는 차이는 없어야 한다.
단, 사용자가 노드 또는 컨테이너 내부에서 cgroup 파일 시스템에 직접
접근하는 경우는 예외이다.
사용자들이 노드나 컨테이너 내부에서
cgroup 파일 시스템에 직접 접근하지 않는 한,
cgroup v2로 전환할 때 사용자 경험에서 뚜렷한 차이는 없을 것이다.

좀 더 자연스럽게 다듬어보았습니다.

## 리눅스 노드에서 cgroup 버전 확인하기 {#check-cgroup-version}

cgroup 버전은 사용 중인 리눅스 배포판과 OS에 설정된
기본 cgroup 버전에 따라 달라진다. 배포판이 어떤 cgroup 버전을 사용하는지
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
기본 cgroup 버전에 따라 달라진다. 배포판이 어떤 cgroup 버전을 사용하는지
기본 cgroup 버전에 따라 결정된다. 배포판이 어떤 cgroup 버전을 사용하는지

원문을 살려 바꿔보았습니다.


- [cgroup](https://man7.org/linux/man-pages/man7/cgroups.7.html)에 대해 더 알아보기
- [컨테이너 런타임](/ko/docs/concepts/architecture/cri)에 대해 더 알아보기
- [cgroup 드라이버](/ko/docs/setup/production-environment/container-runtimes#cgroup-drivers)에 대해 더 알아보기
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- [cgroup 드라이버](/ko/docs/setup/production-environment/container-runtimes#cgroup-drivers)에 대해 더 알아보기
- [cgroup 드라이버](/ko/docs/setup/production-environment/container-runtimes#cgroup-드라이버)에 대해 더 알아보기

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/localization General issues or PRs related to localization cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/ko Issues or PRs related to Korean language sig/docs Categorizes an issue or PR as relevant to SIG Docs. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[ko] Translate /docs/concepts/architecture/cgroups.md into Korean
3 participants