Skip to content

Commit e8413b6

Browse files
hoangsvithoangsvit
committed
update README-vi.md and vi.toml
1 parent a65b31e commit e8413b6

File tree

2 files changed

+593
-77
lines changed

2 files changed

+593
-77
lines changed

‎README-vi.md

Lines changed: 173 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,71 +1,213 @@
11
# Tài liệu Kubernetes
22

3-
[![Netlify Status](https://api.netlify.com/api/v1/badges/be93b718-a6df-402a-b4a4-855ba186c97d/deploy-status)](https://app.netlify.com/sites/kubernetes-io-main-staging/deploys) [![GitHub release](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest)
3+
[![Trạng thái Netlify](https://api.netlify.com/api/v1/badges/be93b718-a6df-402a-b4a4-855ba186c97d/deploy-status)](https://app.netlify.com/sites/kubernetes-io-main-staging/deploys) [![Phiên bản GitHub](https://img.shields.io/github/release/kubernetes/website.svg)](https://github.com/kubernetes/website/releases/latest)
44

5-
Chào mừng! Kho lưu trữ này chứa tất cả các tài nguyên cần thiết để xây dựng [trang web của Kubernetes và các tài liệu](https://kubernetes.io/). Chúng tôi rất vui vì bạn muốn đóng góp.
5+
Kho lưu trữ này chứa các tài sản cần thiết để xây dựng [trang web và tài liệu Kubernetes](https://kubernetes.io/). Chúng tôi rất vui mừng khi bạn muốn đóng góp!
66

7-
## Đóng góp cho tài liệu
7+
- [Đóng góp vào tài liệu](#contributing-to-the-docs)
8+
- [READMEs địa phương](#localization-readmes)
89

9-
Bạn có thể click vào nút **Fork** ở góc trên bên phải màn hình để tạo bản sao của kho lưu trữ này trong tài khoản GitHub của bạn. Bản sao này được gọi là một bản *fork*. Thực hiện bất kì thay đổi nào mà bạn muốn trong bản fork của bạn và khi bạn sẵn sang gửi những thay đổi đó cho chúng tôi, hãy đến bản fork của bạn và tạo một Pull Request mới để cho chúng tôi biết về nó.
10+
## Sử dụng kho lưu trữ này
1011

11-
Một khi Pull Request của bạn được tạo, reviewer sẽ chịu trách nhiệm cung cấp các phản hồi rõ ràng, có thể thực hiện được. Là chủ sở hữu của pull request, **bạn có trách nhiệm sửa đổi Pull Request của mình để giải quyết các phản hồi bởi reviewer.** Ngoài ra, lưu ý rằng bạn có thể có nhiều hơn một reviewer cung cấp cho bạn các phản hồi hoặc bạn có thể nhận được phản hồi từ reviewer khác với reviewer ban đầu được chỉ định. Hơn nữa, trong một số trường hợp, một trong những reviewer của bạn có thể yêu cầu đánh giá kỹ thuật từ [Kubernetes tech reviewer](https://github.com/kubernetes/website/wiki/Tech-reviewers) khi cần. Các reviewers sẽ cố gắng hết sức để cung cấp phản hồi một cách kịp thời nhưng thời gian phản hồi có thể thay đổi tùy theo hoàn cảnh.
12+
Bạn có thể chạy trang web này ở chế độ local bằng cách sử dụng [Hugo (Phiên bản mở rộng)](https://gohugo.io/), hoặc bạn có thể chạy nó trong một container runtime. Chúng tôi mạnh mẽ khuyến nghị sử dụng container runtime, vì nó mang lại tính nhất quán trong triển khai với trang web thực tế.
1213

13-
Để biết thêm thông tin về việc đóng góp cho tài liệu Kubernetes, hãy xem:
14+
## Yêu cầu tiên quyết
1415

15-
* [Bắt đầu đóng góp](https://kubernetes.io/docs/contribute/start/)
16-
* [Các giai đoạn thay đổi tài liệu](http://kubernetes.io/docs/contribute/intermediate#view-your-changes-locally)
17-
* [Sử dụng các trang templates](https://kubernetes.io/docs/contribute/style/page-content-types/)
18-
* [Hướng dẫn biểu mẫu tài liệu](http://kubernetes.io/docs/contribute/style/style-guide/)
19-
* [Địa phương hóa tài liệu Kubernetes](https://kubernetes.io/docs/contribute/localization/)
16+
Để sử dụng kho lưu trữ này, bạn cần cài đặt các phần mềm sau trên máy tính của bạn:
2017

18+
- [npm](https://www.npmjs.com/)
19+
- [Go](https://go.dev/)
20+
- [Hugo (Phiên bản mở rộng)](https://gohugo.io/)
21+
- Một container runtime, như [Docker](https://www.docker.com/).
2122

22-
## Chạy website cục bộ dùng Docker
23+
Trước khi bắt đầu, hãy cài đặt các phụ thuộc. Sao chép kho lưu trữ và di chuyển đến thư mục:
2324

24-
Cách được đề xuất để chạy trang web Kubernetes cục bộ là dùng [Docker](https://docker.com) image chứa trình tạo web tĩnh [Hugo](https://gohugo.io).
25+
```bash
26+
git clone https://github.com/kubernetes/website.git
27+
cd website
28+
```
2529

26-
> Nếu bạn làm việc trên môi trường Windows, bạn sẽ cần thêm môt vài công cụ mà bạn có thể cài đặt với [Chocolatey](https://chocolatey.org). `choco install make`
30+
Trang web Kubernetes sử dụng [chủ đề Docsy Hugo](https://github.com/google/docsy#readme). Ngay cả khi bạn dự định chạy trang web trong một vùng chứa, chúng tôi thực sự khuyên bạn nên kéo mô-đun con và các phần phụ thuộc phát triển khác bằng cách chạy như sau:
2731

28-
> Nếu bạn không muốn dùng Docker để chạy trang web cục bộ, hãy xem [Chạy website cục bộ dùng Hugo](#chạy-website-cục-bộ-dùng-hugo) dưới đây.
32+
### Windows
33+
34+
```powershell
35+
# fetch submodule dependencies
36+
git submodule update --init --recursive --depth 1
37+
```
2938

30-
Nếu bạn có Docker đang [up và running](https://www.docker.com/get-started), build `kubernetes-hugo` Docker image cục bộ:
39+
### Linux / other Unix
3140

3241
```bash
33-
make container-image
42+
# fetch submodule dependencies
43+
make module-init
3444
```
3545

36-
Khi image đã được built, bạn có thể chạy website cục bộ:
46+
## Chạy trang web bằng container
47+
48+
Để xây dựng trang web trong một container, chạy lệnh sau:
3749

3850
```bash
51+
# Bạn có thể đặt biến $CONTAINER_ENGINE thành tên của bất kỳ công cụ container giống Docker nào
3952
make container-serve
4053
```
4154

42-
Mở trình duyệt và đến địa chỉ http://localhost:1313 để xem website. Khi bạn thay đổi các file nguồn, Hugo cập nhật website và buộc làm mới trình duyệt.
55+
Nếu bạn thấy lỗi, điều đó có thể có nghĩa là container Hugo không có đủ tài nguyên điện toán. Để giải quyết nó, hãy tăng số lượng sử dụng CPU và bộ nhớ được phép cho Docker trên máy của bạn ([macOS] (<https://docs.docker.com/desktop/setings/mac/>) và [windows] (https: // tài liệu .Docker.com/Desktop/Cài đặt/Windows/)).
56+
57+
Mở trình duyệt của bạn để <http://localhost:1313> để xem trang web. Khi bạn thay đổi các tệp nguồn, Hugo cập nhật trang web và buộc phải làm mới trình duyệt.
58+
59+
## Chạy trang web cục bộ bằng cách sử dụng Hugo
60+
61+
Đảm bảo cài đặt phiên bản mở rộng Hugo được chỉ định bởi biến môi trường `Hugo_version` trong tệp [`netlify.toml`] (netlify.toml#l11).
62+
63+
Để cài đặt các phụ thuộc, triển khai và kiểm tra trang web cục bộ, chạy:
64+
65+
- Đối với MacOS và Linux
66+
67+
```bash
68+
npm ci
69+
make serve
70+
```
71+
72+
- Đối với Windows (PowerShell)
73+
74+
```powershell
75+
npm ci
76+
hugo.exe server --buildFuture --environment development
77+
```
78+
79+
Điều này sẽ khởi động máy chủ Hugo cục bộ trên cổng 1313. Mở trình duyệt của bạn thành <http://localhost:1313> để xem trang web. Khi bạn thay đổi các tệp nguồn, Hugo cập nhật trang web và buộc phải làm mới trình duyệt.
80+
81+
## Xây dựng các trang tài liệu tham khảo API
82+
83+
Các trang tài liệu tham khảo API nằm trong `content/en/docs/reference/kubernetes-api` được xây dựng từ Swagger specification, còn được gọi là OpenAPI specification, sử dụng <https://github.com/kubernetes-sigs/reference-docs/tree/master/gen-resourcesdocs>.
84+
85+
Để cập nhật các trang tài liệu tham khảo cho một phiên bản Kubernetes mới, làm theo các bước sau:
86+
87+
1. Kéo về submodule `api-ref-generator`:
88+
89+
```bash
90+
git submodule update --init --recursive --depth 1
91+
```
92+
93+
2. Cập nhật Swagger specification:
94+
95+
```bash
96+
curl 'https://raw.githubusercontent.com/kubernetes/kubernetes/master/api/openapi-spec/swagger.json' > api-ref-assets/api/swagger.json
97+
```
98+
99+
3. Trong `api-ref-assets/config/`, điều chỉnh các tệp `toc.yaml` và `fields.yaml` để phản ánh các thay đổi của phiên bản mới.
100+
101+
4. Tiếp theo, xây dựng các trang:
102+
103+
```bash
104+
make api-reference
105+
```
106+
107+
Bạn có thể kiểm tra kết quả trên máy cục bộ bằng cách xây dựng và chạy trang web từ một container:
108+
109+
```bash
110+
make container-serve
111+
```
43112

44-
## Chạy website cục bộ dùng Hugo
113+
Trong trình duyệt web, truy cập vào <http://localhost:1313/docs/reference/kubernetes-api/> để xem tài liệu tham khảo API.
45114

46-
Hãy xem [tài liệu chính thức của Hugo](https://gohugo.io/getting-started/installing/) cho việc hướng dẫn cài đặt Hugo. Đảm bảo cài đặt phiên bản mở rộng của Hugo được xác định bởi biến môi trường `HUGO_VERSION` trong file [`netlify.toml`](netlify.toml#L9)
115+
5. Khi tất cả các thay đổi của hợp đồng mới được phản ánh vào các tệp cấu hình `toc.yaml` và `fields.yaml`, tạo một Pull Request với các trang tài liệu tham khảo API mới được tạo ra.
47116

48-
Để chạy website cục bộ khi Hugo được cài đặt:
117+
## Khắc phục sự cố
118+
119+
### Lỗi: failed to transform resource: TOCSS: failed to transform "scss/main.scss" (text/x-scss): tính năng này không khả dụng trong phiên bản Hugo hiện tại của bạn
120+
121+
Hugo được cung cấp dưới dạng hai bộ công cụ nhị phân vì lý do kỹ thuật. Trang web hiện tại chạy dựa trên phiên bản **Hugo Extended** duy nhất. Trong [trang phát hành](https://github.com/gohugoio/hugo/releases), tìm kiếm các bản lưu trữ có chứa từ khóa `extended` trong tên. Để xác nhận, chạy `hugo version` và tìm từ khóa `extended`.
122+
123+
### Khắc phục sự cố trên macOS với quá nhiều tệp mở
124+
125+
Nếu bạn chạy `make serve` trên macOS và nhận được lỗi sau đây:
49126

50127
```bash
51-
make serve
128+
ERROR 2020/08/01 19:09:18 Error: listen tcp 127.0.0.1:1313: socket: too many open files
129+
make: *** [serve] Error 1
130+
```
131+
132+
Hãy kiểm tra giới hạn hiện tại cho số tệp mở:
133+
134+
`launchctl limit maxfiles`
135+
136+
Sau đó, chạy các lệnh sau (được thích nghi từ <https://gist.github.com/tombigel/d503800a282fcadbee14b537735d202c>):
137+
138+
```shell
139+
#!/bin/sh
140+
141+
# Đây là các liên kết gist gốc, liên kết đến các gist của tôi ngay bây giờ.
142+
# curl -O https://gist.githubusercontent.com/a2ikm/761c2ab02b7b3935679e55af5d81786a/raw/ab644cb92f216c019a2f032bbf25e258b01d87f9/limit.maxfiles.plist
143+
# curl -O https://gist.githubusercontent.com/a2ikm/761c2ab02b7b3935679e55af5d81786a/raw/ab644cb92f216c019a2f032bbf25e258b01d87f9/limit.maxproc.plist
144+
145+
curl -O https://gist.githubusercontent.com/tombigel/d503800a282fcadbee14b537735d202c/raw/ed73cacf82906fdde59976a0c8248cce8b44f906/limit.maxfiles.plist
146+
curl -O https://gist.githubusercontent.com/tombigel/d503800a282fcadbee14b537735d202c/raw/ed73cacf82906fdde59976a0c8248cce8b44f906/limit.maxproc.plist
147+
148+
sudo mv limit.maxfiles.plist /Library/LaunchDaemons
149+
sudo mv limit.maxproc.plist /Library/LaunchDaemons
150+
151+
sudo chown root:wheel /Library/LaunchDaemons/limit.maxfiles.plist
152+
sudo chown root:wheel /Library/LaunchDaemons/limit.maxproc.plist
153+
154+
sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist
52155
```
53156

54-
Câu lệnh trên sẽ khởi động server Hugo cục bộ trên cổng 1313. Mở trình duyệt và đến địa chỉ http://localhost:1313 để xem website. Khi bạn thay đổi các file nguồn, Hugo cập nhật website và buộc làm mới trình duyệt.
157+
Điều này hoạt động cho cả macOS Catalina và Mojave.
55158

56-
## Cộng đồng, thảo luận, đóng góp và hỗ trợ
159+
## Tham gia với SIG Docs
57160

58-
Tìm hiểu cách tham gia với cộng đồng Kubernetes trên [trang cộng đồng](http://kubernetes.io/community/).
161+
Tìm hiểu thêm về cộng đồng SIG Docs Kubernetes và cuộc họp trên [trang cộng đồng](https://github.com/kubernetes/community/tree/master/sig-docs#meetings).
59162

60-
Bạn có thể tiếp cận những maintainers của dự án này tại:
163+
Bạn cũng có thể liên hệ với những người duy trì dự án này tại:
61164

62165
- [Slack](https://kubernetes.slack.com/messages/sig-docs)
166+
- [Nhận lời mời tham gia Slack này](https://slack.k8s.io/)
63167
- [Mailing List](https://groups.google.com/forum/#!forum/kubernetes-sig-docs)
64168

65-
### Quy tắc ứng xử
169+
## Đóng góp vào tài liệu
170+
171+
Bạn có thể nhấp vào nút **Fork** ở phía trên bên phải của màn hình để tạo một bản sao của kho lưu trữ này trong tài khoản GitHub của bạn. Bản sao này được gọi là _fork_. Thực hiện bất kỳ thay đổi nào bạn muốn trong fork của bạn, và khi bạn sẵn sàng gửi những thay đổi đó cho chúng tôi, hãy vào fork của bạn và tạo một pull request mới để thông báo cho chúng tôi biết về nó.
172+
173+
Sau khi pull request của bạn được tạo, một người xem Kubernetes sẽ chịu trách nhiệm cung cấp phản hồi rõ ràng, có thể thực hiện được. Là chủ sở hữu của pull request, **bạn có trách nhiệm sửa đổi pull request của mình để giải quyết phản hồi đã được cung cấp cho bạn bởi người xem Kubernetes.**
174+
175+
Lưu ý rằng bạn có thể nhận được phản hồi từ nhiều người đánh giá Kubernetes hoặc bạn có thể nhận được phản hồi từ một người đánh giá Kubernetes khác với người được chỉ định ban đầu để cung cấp phản hồi.
176+
177+
Hơn nữa, trong một số trường hợp, một trong những người đánh giá của bạn có thể yêu cầu một đánh giá kỹ thuật từ một người đánh giá kỹ thuật Kubernetes khi cần thiết. Người đánh giá sẽ cố gắng cung cấp phản hồi một cách kịp thời, nhưng thời gian phản hồi có thể thay đổi tùy thuộc vào các tình huống.
178+
179+
Để biết thêm thông tin về việc đóng góp vào tài liệu Kubernetes, hãy xem:
180+
181+
- [Đóng góp vào tài liệu Kubernetes](https://kubernetes.io/docs/contribute/)
182+
- [Loại nội dung trang](https://kubernetes.io/docs/contribute/style/page-content-types/)
183+
- [Hướng dẫn về phong cách tài liệu](https://kubernetes.io/docs/contribute/style/style-guide/)
184+
- [Dịch tài liệu Kubernetes](https://kubernetes.io/docs/contribute/localization/)
185+
- [Giới thiệu về tài liệu Kubernetes](https://www.youtube.com/watch?v=pprMgmNzDcw)
186+
187+
### Đại sứ đóng góp mới
188+
189+
Nếu bạn cần trợ giúp bất kỳ lúc nào khi đóng góp, [Đại sứ đóng góp mới](https://kubernetes.io/docs/contribute/advanced/#serve-as-a-new-contributor-ambassador) là điểm liên lạc tốt. Đây là những người phê duyệt SIG Docs có trách nhiệm hướng dẫn các đóng góp viên mới và giúp họ qua những pull request đầu tiên. Nơi tốt nhất để liên hệ với Đại sứ đóng góp mới là trên [Kubernetes Slack](https://slack.k8s.io/). Đại sứ đóng góp mới hiện tại cho SIG Docs:
190+
191+
| Name | Slack | GitHub |
192+
| -------------------------- | -------------------------- | -------------------------- |
193+
| Arsh Sharma | @arsh | @RinkiyaKeDad |
194+
195+
## Các tệp README đa ngôn ngữ
196+
197+
| Language | Language |
198+
| -------------------------- | -------------------------- |
199+
| [Chinese](README-zh.md) | [Korean](README-ko.md) |
200+
| [French](README-fr.md) | [Polish](README-pl.md) |
201+
| [German](README-de.md) | [Portuguese](README-pt.md) |
202+
| [Hindi](README-hi.md) | [Russian](README-ru.md) |
203+
| [Indonesian](README-id.md) | [Spanish](README-es.md) |
204+
| [Italian](README-it.md) | [Ukrainian](README-uk.md) |
205+
| [Japanese](README-ja.md) | [Vietnamese](README-vi.md) |
206+
207+
## Quy tắc ứng xử
66208

67-
Sự tham gia vào cộng đồng Kubernetes được điểu chỉnh bởi [Kubernetes Code of Conduct](code-of-conduct.md).
209+
Sự tham gia vào cộng đồng Kubernetes được điều chỉnh bởi [Quy tắc ứng xử của CNCF](https://github.com/cncf/foundation/blob/main/code-of-conduct.md).
68210

69-
## Cảm ơn!
211+
## Cảm ơn bạn
70212

71-
Kubernetes phát triển mạnh mẽ về sự tham gia của cộng đồng và chúng tôi đánh giá cao những đóng góp của bạn cho trang web và tài liệu của chúng tôi!
213+
Kubernetes phát triển dựa trên sự tham gia của cộng đồng, và chúng tôi đánh giá cao những đóng góp của bạn cho trang web và tài liệu của chúng tôi!

0 commit comments

Comments
 (0)