Skip to content

Conversation

@aoi1
Copy link
Contributor

@aoi1 aoi1 commented Jan 4, 2026

Description

Translate content/en/docs/tasks/administer-cluster/access-cluster-api.md

Issue

Closes: #53608

Preview

preview URL: https://deploy-preview-53906--kubernetes-io-main-staging.netlify.app/ja/docs/tasks/administer-cluster/access-cluster-api

/area localization
/language ja

@k8s-ci-robot k8s-ci-robot added do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. labels Jan 4, 2026
@k8s-ci-robot
Copy link
Contributor

Welcome @aoi1!

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 requested review from kfess and t-inu January 4, 2026 03:32
@k8s-ci-robot k8s-ci-robot added area/localization General issues or PRs related to localization language/ja Issues or PRs related to Japanese 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. labels Jan 4, 2026
@aoi1 aoi1 changed the title Translate access-cluster-api.md to Japanese [ja] Translate access-cluster-api.md to Japanese Jan 4, 2026
@aoi1 aoi1 changed the title [ja] Translate access-cluster-api.md to Japanese [ja] Translate content/en/docs/tasks/administer-cluster/access-cluster-api.md to Japanese Jan 4, 2026
@netlify
Copy link

netlify bot commented Jan 4, 2026

Pull request preview available for checking

Built without sensitive environment variables

Name Link
🔨 Latest commit 6207661
🔍 Latest deploy log https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/6961fb0c8b12910008c4b6be
😎 Deploy Preview https://deploy-preview-53906--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.

kubectl config view
```

多くの[examples](https://github.com/kubernetes/examples/tree/master/)がkubectlの使用方法について紹介しています。完全なドキュメントは[kubectlマニュアル](/docs/reference/kubectl/)にあります。
Copy link
Contributor Author

Choose a reason for hiding this comment

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

examplesを「例」にするか迷いましたが、そのままexampleと書かれているドキュメントもありそうだったのでこのままにしています。

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
多くの[examples](https://github.com/kubernetes/examples/tree/master/)がkubectlの使用方法について紹介しています。完全なドキュメントは[kubectlマニュアル](/docs/reference/kubectl/)にあります
多くの[examples](https://github.com/kubernetes/examples/tree/master/)で、kubectlの使用方法について紹介しています
完全なドキュメントは[kubectlマニュアル](/docs/reference/kubectl/)にあります。

@aoi1 aoi1 marked this pull request as ready for review January 4, 2026 08:24
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/work-in-progress Indicates that a PR should not merge because it is a work in progress. label Jan 4, 2026
@k8s-ci-robot k8s-ci-robot requested a review from nasa9084 January 4, 2026 08:24
Copy link
Member

@kfess kfess left a comment

Choose a reason for hiding this comment

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

コントリビューションありがとうございます!
レビュー & コメントしました。

個別のレビューコメントに加えて、
全体を通して、下記についてご対応いただけますでしょうか。

  • 句読点「。」の後に改行を追加
  • 「:(全角)」を「: (半角)」に変更
  • 全角の括弧を半角の括弧に変更


クラスターにアクセスするには、クラスターのロケーションを知り、アクセス用の認証情報が必要です。通常、これは[はじめに](/docs/setup/)を進めていく中で自動的に設定されるか、他の誰かがクラスターをセットアップしてあなたに認証情報とロケーションを提供してくれます。

このコマンドで、kubectlが認識しているロケーションと認証情報を確認できます:
Copy link
Member

Choose a reason for hiding this comment

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

ref: https://kubernetes.io/ja/docs/contribute/localization/

記号類は感嘆符「!」と疑問符「?」のみ全角、それ以外は半角で表記

Suggested change
このコマンドで、kubectlが認識しているロケーションと認証情報を確認できます
このコマンドで、kubectlが認識しているロケーションと認証情報を確認できます:

kubectl config view
```

多くの[examples](https://github.com/kubernetes/examples/tree/master/)がkubectlの使用方法について紹介しています。完全なドキュメントは[kubectlマニュアル](/docs/reference/kubectl/)にあります。
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
多くの[examples](https://github.com/kubernetes/examples/tree/master/)がkubectlの使用方法について紹介しています。完全なドキュメントは[kubectlマニュアル](/docs/reference/kubectl/)にあります
多くの[examples](https://github.com/kubernetes/examples/tree/master/)で、kubectlの使用方法について紹介しています
完全なドキュメントは[kubectlマニュアル](/docs/reference/kubectl/)にあります。


### REST APIへの直接アクセス {#directly-accessing-the-rest-api}

kubectlはAPIサーバーの特定と認証を扱います。`curl`や`wget`などのHTTPクライアント、またはブラウザでREST APIに直接アクセスしたい場合は、APIサーバーを特定して認証する方法がいくつかあります:
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
kubectlはAPIサーバーの特定と認証を扱います。`curl``wget`などのHTTPクライアント、またはブラウザでREST APIに直接アクセスしたい場合は、APIサーバーを特定して認証する方法がいくつかあります:
kubectlはAPIサーバーの特定と認証を扱います。
`curl``wget`などのHTTPクライアント、またはブラウザでREST APIに直接アクセスしたい場合は、APIサーバーを特定して認証する方法がいくつかあります:


kubectlはAPIサーバーの特定と認証を扱います。`curl`や`wget`などのHTTPクライアント、またはブラウザでREST APIに直接アクセスしたい場合は、APIサーバーを特定して認証する方法がいくつかあります:

1. kubectlをプロキシモードで実行する(推奨)。この方法は、保存されたAPIサーバーのロケーションを使用し、自己署名証明書を使用してAPIサーバーを検証するため、推奨されます。この方法では中間者攻撃(MITM)は不可能です。
Copy link
Member

Choose a reason for hiding this comment

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

ref: https://kubernetes.io/ja/docs/contribute/localization/

記号類は感嘆符「!」と疑問符「?」のみ全角、それ以外は半角で表記
日本語文では、文章の途中で改行を行わない。句点「。」もしくは行末のコロン:で改行する

Suggested change
1. kubectlをプロキシモードで実行する(推奨)。この方法は、保存されたAPIサーバーのロケーションを使用し、自己署名証明書を使用してAPIサーバーを検証するため、推奨されます。この方法では中間者攻撃MITMは不可能です。
1. kubectlをプロキシモードで実行する(推奨)。この方法は、保存されたAPIサーバーのロケーションを使用し、自己署名証明書を使用してAPIサーバーを検証するため、推奨されます。この方法では中間者攻撃(MITM)は不可能です。

Copy link
Member

Choose a reason for hiding this comment

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

これ以降についても、下記の対応をお願いできますでしょうか!

  • 句読点「。」の後に改行を追加
  • 「:(全角)」を「: (半角)」に変更
  • 全角の括弧を半角の括弧に変更


サポートされているバージョンについては、[https://github.com/kubernetes-client/haskell/releases](https://github.com/kubernetes-client/haskell/releases)を参照してください。

[Haskell client](https://github.com/kubernetes-client/haskell)は、kubectl CLIと同じ[kubeconfigファイル](/docs/concepts/configuration/organize-cluster-access-kubeconfig/)を使用して、APIサーバーを特定し、認証できます。この[example](https://github.com/kubernetes-client/haskell/blob/master/kubernetes-client/example/App.hs)を参照してください:
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
[Haskell client](https://github.com/kubernetes-client/haskell)は、kubectl CLIと同じ[kubeconfigファイル](/docs/concepts/configuration/organize-cluster-access-kubeconfig/)を使用して、APIサーバーを特定し、認証できます。この[example](https://github.com/kubernetes-client/haskell/blob/master/kubernetes-client/example/App.hs)を参照してください:
[Haskellクライアント](https://github.com/kubernetes-client/haskell)は、kubectl CLIと同じ[kubeconfigファイル](/docs/concepts/configuration/organize-cluster-access-kubeconfig/)を使用して、APIサーバーを特定し、認証できます。
この[example](https://github.com/kubernetes-client/haskell/blob/master/kubernetes-client/example/App.hs)を参照してください:


上記の例では`--insecure`フラグを使用しています。これは、MITM攻撃を受ける可能性を残します。kubectlがクラスターにアクセスする際は、保存されたルート証明書とクライアント証明書を使用してサーバーにアクセスします(これらは`~/.kube`ディレクトリにインストールされています)。クラスター証明書は通常自己署名されているため、HTTPクライアントにルート証明書を使用させるには特別な設定が必要な場合があります。

一部のクラスターでは、APIサーバーは認証を必要としません。localhostで提供されるか、ファイアウォールで保護されている可能性があります。これには標準がありません。[Kubernetes APIへのアクセスコントロール](/docs/concepts/security/controlling-access)では、クラスター管理者としてこれを設定する方法を説明しています。
Copy link
Member

Choose a reason for hiding this comment

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

"; it may serve on localhost, or be protected by a firewall." について、認証が不要な場合の例を列挙していると捉えました。そのため、例であることを明示的に和訳しました。

There is not a standard for this. の訳について、"for this" が何を意味しているのか少し不明瞭だったため、補って訳しました。

Suggested change
一部のクラスターでは、APIサーバーは認証を必要としません。localhostで提供されるか、ファイアウォールで保護されている可能性があります。これには標準がありません[Kubernetes APIへのアクセスコントロール](/docs/concepts/security/controlling-access)では、クラスター管理者としてこれを設定する方法を説明しています。
一部のクラスターでは、APIサーバーは認証を必要としません。localhostで提供される場合や、ファイアウォールで保護されている場合などです。このように、認証を必要としない構成を行うための標準的な方法はありません[Kubernetes APIへのアクセスコントロール](/docs/concepts/security/controlling-access)では、クラスター管理者としてこれを設定する方法を説明しています。

Comment on lines 132 to 133

上記の例では`--insecure`フラグを使用しています。これは、MITM攻撃を受ける可能性を残します。kubectlがクラスターにアクセスする際は、保存されたルート証明書とクライアント証明書を使用してサーバーにアクセスします(これらは`~/.kube`ディレクトリにインストールされています)。クラスター証明書は通常自己署名されているため、HTTPクライアントにルート証明書を使用させるには特別な設定が必要な場合があります。
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
上記の例では`--insecure`フラグを使用しています。これは、MITM攻撃を受ける可能性を残します。kubectlがクラスターにアクセスする際は、保存されたルート証明書とクライアント証明書を使用してサーバーにアクセスします(これらは`~/.kube`ディレクトリにインストールされています)。クラスター証明書は通常自己署名されているため、HTTPクライアントにルート証明書を使用させるには特別な設定が必要な場合があります。
上記の例では`--insecure`フラグを使用しています。これは、MITM攻撃を受ける可能性があります。kubectlがクラスターにアクセスする際は、保存されたルート証明書とクライアント証明書を使用してサーバーにアクセスします(これらは`~/.kube`ディレクトリにインストールされています)。クラスター証明書は通常自己署名されているため、HTTPクライアントにルート証明書を使用させるには特別な設定が必要な場合があります。

)

func main() {
// uses the current context in kubeconfig
Copy link
Member

Choose a reason for hiding this comment

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

通常の開発では、ソースコード内に英語でコメントを書くことが多い気がしますが、
このドキュメントに記載されているのはあくまでも参照用のソースコードなので、和訳してしまって良いように思いました。

Copy link
Member

Choose a reason for hiding this comment

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

+1, 和訳していただけると助かります 👍

@aoi1
Copy link
Contributor Author

aoi1 commented Jan 5, 2026

レビューいただきありがとうございます。頂いたコメントに関して対応を進めていきます。

@Okabe-Junya
Copy link
Member

Okabe-Junya commented Jan 5, 2026

コントリビューション、レビュー共にありがとうございます!
nit comment で恐縮ですが、 commit message は原則英語で記載していただけると助かります(git の履歴は日本語話者以外の人も確認するため)

(あまり明文化されていなくて恐縮ですが...)l10n issue/PR に関しては、commit message, issue/pr title の英語表記は SHOULD、issue/pr description は可能な限り英語で記載する、それ以外は各言語での表記でほとんどの場合は問題ないです

このPRは squash merge で取り込むようにするので、git amend/rebase 等でのご自身での修正は不要です

cf. https://www.kubernetes.dev/docs/guide/pull-requests/#squashing

/label tide/merge-method-squash

@k8s-ci-robot k8s-ci-robot added the tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges. label Jan 5, 2026
@Okabe-Junya
Copy link
Member

/assign

@k8s-ci-robot k8s-ci-robot added the do-not-merge/invalid-commit-message Indicates that a PR should not merge because it has an invalid commit message. label Jan 7, 2026
@aoi1 aoi1 requested a review from Okabe-Junya January 7, 2026 23:33
@aoi1
Copy link
Contributor Author

aoi1 commented Jan 7, 2026

@Okabe-Junya レビューありがとうございます。

nit comment で恐縮ですが、 commit message は原則英語で記載していただけると助かります(git の履歴は日本語話者以外の人も確認するため)

承知いたしました。確かに日本語話者以外も確認しますよね、思い至らずすみません。今後気をつけます。

@aoi1 aoi1 requested a review from kfess January 7, 2026 23:34
@aoi1
Copy link
Contributor Author

aoi1 commented Jan 7, 2026

@kfess レビュー対応完了しました!一括置換など行ったせいで一部提案を取り込めずOutdatedになってしまった部分があります、すみません...
確認が手間だと思いますがよろしくお願いします🙇

@kfess
Copy link
Member

kfess commented Jan 8, 2026

@aoi1
修正ありがとうございます。細かいですが 1 点のみコメントしました。
修正いただければ、LGTM です!

@aoi1 aoi1 requested a review from kfess January 8, 2026 13:54
@aoi1
Copy link
Contributor Author

aoi1 commented Jan 8, 2026

@kfess 迅速に確認いただきありがとうございます!頂いた提案を取り込みました。

@kfess
Copy link
Member

kfess commented Jan 8, 2026

@aoi1

早速の修正、ありがとうございます!
/lgtm

@k8s-ci-robot k8s-ci-robot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jan 8, 2026
@k8s-ci-robot
Copy link
Contributor

LGTM label has been added.

DetailsGit tree hash: 443bdb8f6d9f3e624e5e6e82c87884cface57bea

@t-inu
Copy link
Member

t-inu commented Jan 8, 2026

Apply suggestion from @aoi1
というコミットメッセージにアットマークが入っているため、マージ不可のラベルがついてしまっています。
コミットメッセージを変更する必要がありますね。

@aoi1
Copy link
Contributor Author

aoi1 commented Jan 8, 2026

#53906 (comment)
こちらにあるとおりコミットメッセージは勝手にsquashされるから大丈夫だと思っていたのですが、手動で直さないとこの先のフローが動かせないという感じでしょうか...?
直す必要があればrebaseします。

@kfess
Copy link
Member

kfess commented Jan 9, 2026

今回の invalid commit message のラベルと同様のラベルが付与された PR があり、コミット履歴の強制的な書き換えを行うように言われていました。
そのため、少し面倒ですが、今回も rebase / force-push は必要になるかと思います。

@aoi1 aoi1 force-pushed the aoi1/issue-53608 branch from 4051451 to fa3f2e8 Compare January 10, 2026 07:07
@aoi1 aoi1 force-pushed the aoi1/issue-53608 branch from fa3f2e8 to 6207661 Compare January 10, 2026 07:08
@k8s-ci-robot k8s-ci-robot removed the do-not-merge/invalid-commit-message Indicates that a PR should not merge because it has an invalid commit message. label Jan 10, 2026
@aoi1
Copy link
Contributor Author

aoi1 commented Jan 10, 2026

@kfess お待たせしました!コミットメッセージを修正したのでラベルが外されたようです!

@kfess
Copy link
Member

kfess commented Jan 10, 2026

対応ありがとうございます!
/lgtm

Copy link
Member

@Okabe-Junya Okabe-Junya left a comment

Choose a reason for hiding this comment

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

ありがとうございます、LGTMです

/approve

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: Okabe-Junya

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details 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 the approved Indicates a PR has been approved by an approver from all required OWNERS files. label Jan 11, 2026
@k8s-ci-robot k8s-ci-robot merged commit a1a534c into kubernetes:main Jan 11, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

approved Indicates a PR has been approved by an approver from all required OWNERS files. area/localization General issues or PRs related to localization cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. language/ja Issues or PRs related to Japanese language lgtm "Looks good to me", indicates that a PR is ready to be merged. 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. tide/merge-method-squash Denotes a PR that should be squashed by tide when it merges.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[ja] Translate content/en/docs/tasks/administer-cluster/access-cluster-api.md

5 participants