Merge pull request #21120 from oke-py/ja/namespace
update /ja/docs/concepts/overview/working-with-objects/namespaces/
This commit is contained in:
@@ -20,25 +20,25 @@ Namespaceは、複数のチーム・プロジェクトにまたがる多くの
|
|||||||
数人から数十人しかユーザーのいないクラスターに対して、あなたはNamespaceを作成したり、考える必要は全くありません。
|
数人から数十人しかユーザーのいないクラスターに対して、あなたはNamespaceを作成したり、考える必要は全くありません。
|
||||||
Kubernetesが提供するNamespaceの機能が必要となった時に、Namespaceの使用を始めてください。
|
Kubernetesが提供するNamespaceの機能が必要となった時に、Namespaceの使用を始めてください。
|
||||||
|
|
||||||
Namespaceは名前空間のスコープを提供します。リソース名は単一のNamespace内ではユニークである必要がありますが、Namespace全体ではその必要はありません。
|
Namespaceは名前空間のスコープを提供します。リソース名は単一のNamespace内ではユニークである必要がありますが、Namespace全体ではその必要はありません。Namespaceは相互にネストすることはできず、各Kubernetesリソースは1つのNamespaceにのみ存在できます。
|
||||||
|
|
||||||
Namespaceは、複数のユーザーの間でクラスターリソースを分割する方法です。(これは[リソースクォータ](/docs/concepts/policy/resource-quotas/)を介して分割します。)
|
Namespaceは、複数のユーザーの間でクラスターリソースを分割する方法です。(これは[リソースクォータ](/docs/concepts/policy/resource-quotas/)を介して分割します。)
|
||||||
|
|
||||||
Kubernetesの将来的なバージョンにおいて、同一のNamespace内のオブジェクトは、デフォルトで同一のアクセスコントロールポリシーが適用されます。
|
Kubernetesの将来的なバージョンにおいて、同一のNamespace内のオブジェクトは、デフォルトで同一のアクセスコントロールポリシーが適用されます。
|
||||||
|
|
||||||
同じアプリケーションの異なるバージョンなど、少し違うリソースをただ分割するだけに、複数のNamespaceを使う必要はありません。
|
同じアプリケーションの異なるバージョンなど、少し違うリソースをただ分割するだけに、複数のNamespaceを使う必要はありません。
|
||||||
同一のNamespace内でリソースを区別するためには[ラベル](/docs/user-guide/labels)を使用してください。
|
同一のNamespace内でリソースを区別するためには[ラベル](/ja/docs/concepts/overview/working-with-objects/labels/)を使用してください。
|
||||||
|
|
||||||
## Namespaceを利用する
|
## Namespaceを利用する
|
||||||
|
|
||||||
Namespaceの作成と削除方法は[Namespaceの管理ガイドドキュメント](/docs/admin/namespaces)に記載されています。
|
Namespaceの作成と削除方法は[Namespaceの管理ガイドドキュメント](/docs/tasks/administer-cluster/namespaces/)に記載されています。
|
||||||
|
|
||||||
### Namespaceの表示
|
### Namespaceの表示
|
||||||
|
|
||||||
ユーザーは、以下の方法で単一クラスター内の現在のNamespaceの一覧を表示できます。
|
ユーザーは、以下の方法で単一クラスター内の現在のNamespaceの一覧を表示できます。
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
kubectl get namespaces
|
kubectl get namespace
|
||||||
```
|
```
|
||||||
```
|
```
|
||||||
NAME STATUS AGE
|
NAME STATUS AGE
|
||||||
@@ -56,12 +56,13 @@ Kubernetesの起動時には3つの初期Namespaceが作成されています。
|
|||||||
|
|
||||||
### Namespaceの設定
|
### Namespaceの設定
|
||||||
|
|
||||||
一時的な要求のためにNamespaceを設定したい場合、`--namespace`フラグを使用します。
|
現在のリクエストのNamespaceを設定するには、`--namespace`フラグを使用します。
|
||||||
|
|
||||||
例:
|
例:
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
kubectl --namespace=<insert-namespace-name-here> run nginx --image=nginx
|
kubectl run nginx --image=nginx --namespace=<insert-namespace-name-here>
|
||||||
kubectl --namespace=<insert-namespace-name-here> get pods
|
kubectl get pods --namespace=<insert-namespace-name-here>
|
||||||
```
|
```
|
||||||
|
|
||||||
### Namespace設定の永続化
|
### Namespace設定の永続化
|
||||||
@@ -69,14 +70,14 @@ kubectl --namespace=<insert-namespace-name-here> get pods
|
|||||||
ユーザーはあるコンテキストのその後のコマンドで使うために、コンテキスト内で永続的にNamespaceを保存できます。
|
ユーザーはあるコンテキストのその後のコマンドで使うために、コンテキスト内で永続的にNamespaceを保存できます。
|
||||||
|
|
||||||
```shell
|
```shell
|
||||||
kubectl config set-context $(kubectl config current-context) --namespace=<insert-namespace-name-here>
|
kubectl config set-context --current --namespace=<insert-namespace-name-here>
|
||||||
# Validate it
|
# Validate it
|
||||||
kubectl config view | grep namespace:
|
kubectl config view --minify | grep namespace:
|
||||||
```
|
```
|
||||||
|
|
||||||
## NamespaceとDNS
|
## NamespaceとDNS
|
||||||
|
|
||||||
ユーザーが[Service](/docs/user-guide/services)を作成するとき、Serviceは対応する[DNSエントリ](/ja/docs/concepts/services-networking/dns-pod-service/)を作成します。
|
ユーザーが[Service](/ja/docs/concepts/services-networking/service/)を作成するとき、Serviceは対応する[DNSエントリ](/ja/docs/concepts/services-networking/dns-pod-service/)を作成します。
|
||||||
このエントリは`<service-name>.<namespace-name>.svc.cluster.local`という形式になり,これはもしあるコンテナがただ`<service-name>`を指定していた場合、Namespace内のローカルのServiceに対して名前解決されます。
|
このエントリは`<service-name>.<namespace-name>.svc.cluster.local`という形式になり,これはもしあるコンテナがただ`<service-name>`を指定していた場合、Namespace内のローカルのServiceに対して名前解決されます。
|
||||||
これはデベロップメント、ステージング、プロダクションといって複数のNamespaceをまたいで同じ設定を使う時に効果的です。
|
これはデベロップメント、ステージング、プロダクションといって複数のNamespaceをまたいで同じ設定を使う時に効果的です。
|
||||||
もしユーザーがNamespaceをまたいでアクセスしたい時、 完全修飾ドメイン名(FQDN)を指定する必要があります。
|
もしユーザーがNamespaceをまたいでアクセスしたい時、 完全修飾ドメイン名(FQDN)を指定する必要があります。
|
||||||
@@ -85,7 +86,7 @@ kubectl config view | grep namespace:
|
|||||||
|
|
||||||
ほとんどのKubernetesリソース(例えば、Pod、Service、ReplicationControllerなど)はいくつかのNamespaceにあります。
|
ほとんどのKubernetesリソース(例えば、Pod、Service、ReplicationControllerなど)はいくつかのNamespaceにあります。
|
||||||
しかしNamespaceのリソースそれ自体は単一のNamespace内にありません。
|
しかしNamespaceのリソースそれ自体は単一のNamespace内にありません。
|
||||||
そして[Node](/docs/admin/node)やPersistentVolumeのような低レベルのリソースはどのNamespaceにも属していません。
|
そして[Node](/ja/docs/concepts/architecture/nodes/)やPersistentVolumeのような低レベルのリソースはどのNamespaceにも属していません。
|
||||||
|
|
||||||
どのKubernetesリソースがNamespaceに属しているか、属していないかを見るためには、以下のコマンドで確認できます。
|
どのKubernetesリソースがNamespaceに属しているか、属していないかを見るためには、以下のコマンドで確認できます。
|
||||||
|
|
||||||
@@ -98,3 +99,9 @@ kubectl api-resources --namespaced=false
|
|||||||
```
|
```
|
||||||
|
|
||||||
{{% /capture %}}
|
{{% /capture %}}
|
||||||
|
|
||||||
|
{{% capture whatsnext %}}
|
||||||
|
* [新しいNamespaceの作成](/docs/tasks/administer-cluster/namespaces/#creating-a-new-namespace)について学習してください。
|
||||||
|
* [Namespaceの削除](/docs/tasks/administer-cluster/namespaces/#deleting-a-namespace)について学習してください。
|
||||||
|
|
||||||
|
{{% /capture %}}
|
||||||
|
|||||||
Reference in New Issue
Block a user