From 17d9ad101bbac47a51717df4266b2ebb289d971b Mon Sep 17 00:00:00 2001 From: Keita Akutsu Date: Sun, 26 May 2019 23:13:22 +0900 Subject: [PATCH 1/3] Translate overview/working-with-objects/field-selectors.md in Japanese (#14350) --- .../working-with-objects/field-selectors.md | 64 +++++++++++++++++++ 1 file changed, 64 insertions(+) create mode 100644 content/ja/docs/concepts/overview/working-with-objects/field-selectors.md diff --git a/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md b/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md new file mode 100644 index 0000000000000..201ebe9720515 --- /dev/null +++ b/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md @@ -0,0 +1,64 @@ +--- +title: フィールドセレクター(Field Selectors) +weight: 60 +--- + +_フィールドセレクター(Field Selectors)_ は、1つかそれ以上のリソースフィールドの値を元に[Kubernetesリソースを選択](/docs/concepts/overview/working-with-objects/kubernetes-objects)するためのものです。 +フィールドセレクタークエリの例は以下の通りです。 + +* `metadata.name=my-service` +* `metadata.namespace!=default` +* `status.phase=Pending` + +下記の`kubectl`コマンドは、[`status.phase`](/docs/concepts/workloads/pods/pod-lifecycle/#pod-phase)フィールドの値が`Running`である全てのPodを選択します。 + +```shell +kubectl get pods --field-selector status.phase=Running +``` + +{{< note >}} +フィールドセレクターは本質的にリソースの*フィルタ*となります。デフォルトでは、セレクタ/フィルターが指定されていない場合は、全てのタイプのリソースが取得されます。これは、下記の2つの`kubectl`クエリが同じであることを意味します。 + +```shell +kubectl get pods +kubectl get pods --field-selector "" +``` +{{< /note >}} + +## サポートされているフィールド +サポートされているフィールドセレクターはKubernetesリソースタイプによって異なります。全てのリソースタイプは`metadata.name`と`metadata.namespace`フィールドをサポートしています。サポートされていないフィールドセレクターの使用をするとエラーとなります。 +例えば以下の通りです。 + +```shell +kubectl get ingress --field-selector foo.bar=baz +``` + +``` +Error from server (BadRequest): Unable to find "ingresses" that match label selector "", field selector "foo.bar=baz": "foo.bar" is not a known field selector: only "metadata.name", "metadata.namespace" +``` + +## サポートされているオペレータ + +ユーザは、`=`、`==`や`!=`といったオペレータをフィールドセレクターと組み合わせて使用できます。(`=`と`==`は同義) +例として、下記の`kubectl`コマンドは`default`ネームスペースに属していない全てのKubernetes Serviceを選択します。 + +```shell +kubectl get services --field-selector metadata.namespace!=default +``` + +## 連結されたセレクタ +[ラベル](/docs/concepts/overview/working-with-objects/labels)や他のセレクタと同様に、フィールドセレクターはコンマ区切りのリストとして連結することができます。 +下記の`kubectl`コマンドは、`status.phase`が`Runnning`でなく、かつ`spec.restartPolicy`フィールドが`Always`に等しいような全てのPodを選択します。 + +```shell +kubectl get pods --field-selector=status.phase!=Running,spec.restartPolicy=Always +``` + +## 複数のリソースタイプ + +ユーザは複数のリソースタイプにまたがったフィールドセレクターを利用できます。 +下記の`kubectl`コマンドは、`default`ネームスペースに属していない全てのStatefulSetとServiceを選択します。 + +```shell +kubectl get statefulsets,services --field-selector metadata.namespace!=default +``` \ No newline at end of file From c6d77f467052439403695e5904715fbb6d462bd7 Mon Sep 17 00:00:00 2001 From: Keita Akutsu Date: Sun, 26 May 2019 23:26:46 +0900 Subject: [PATCH 2/3] Update translations for concepts/overview/working-with-objects/field-selectors.md. --- .../overview/working-with-objects/field-selectors.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md b/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md index 201ebe9720515..a4d73227804bd 100644 --- a/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md +++ b/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md @@ -17,7 +17,7 @@ kubectl get pods --field-selector status.phase=Running ``` {{< note >}} -フィールドセレクターは本質的にリソースの*フィルタ*となります。デフォルトでは、セレクタ/フィルターが指定されていない場合は、全てのタイプのリソースが取得されます。これは、下記の2つの`kubectl`クエリが同じであることを意味します。 +フィールドセレクターは本質的にリソースの*フィルタ*となります。デフォルトでは、セレクター/フィルターが指定されていない場合は、全てのタイプのリソースが取得されます。これは、下記の2つの`kubectl`クエリが同じであることを意味します。 ```shell kubectl get pods @@ -37,17 +37,17 @@ kubectl get ingress --field-selector foo.bar=baz Error from server (BadRequest): Unable to find "ingresses" that match label selector "", field selector "foo.bar=baz": "foo.bar" is not a known field selector: only "metadata.name", "metadata.namespace" ``` -## サポートされているオペレータ +## サポートされているオペレーター -ユーザは、`=`、`==`や`!=`といったオペレータをフィールドセレクターと組み合わせて使用できます。(`=`と`==`は同義) +ユーザーは、`=`、`==`や`!=`といったオペレーターをフィールドセレクターと組み合わせて使用できます。(`=`と`==`は同義) 例として、下記の`kubectl`コマンドは`default`ネームスペースに属していない全てのKubernetes Serviceを選択します。 ```shell kubectl get services --field-selector metadata.namespace!=default ``` -## 連結されたセレクタ -[ラベル](/docs/concepts/overview/working-with-objects/labels)や他のセレクタと同様に、フィールドセレクターはコンマ区切りのリストとして連結することができます。 +## 連結されたセレクター +[ラベル](/docs/concepts/overview/working-with-objects/labels)や他のセレクターと同様に、フィールドセレクターはコンマ区切りのリストとして連結することができます。 下記の`kubectl`コマンドは、`status.phase`が`Runnning`でなく、かつ`spec.restartPolicy`フィールドが`Always`に等しいような全てのPodを選択します。 ```shell @@ -56,7 +56,7 @@ kubectl get pods --field-selector=status.phase!=Running,spec.restartPolicy=Alway ## 複数のリソースタイプ -ユーザは複数のリソースタイプにまたがったフィールドセレクターを利用できます。 +ユーザーは複数のリソースタイプにまたがったフィールドセレクターを利用できます。 下記の`kubectl`コマンドは、`default`ネームスペースに属していない全てのStatefulSetとServiceを選択します。 ```shell From eba170ff3145ed7323d8ad6a235083fd529f3710 Mon Sep 17 00:00:00 2001 From: Keita Akutsu Date: Tue, 4 Jun 2019 22:34:12 +0900 Subject: [PATCH 3/3] Update translation for concepts/overview/working-with-objects/field-selectors.md --- .../concepts/overview/working-with-objects/field-selectors.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md b/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md index a4d73227804bd..98d03bfec67dd 100644 --- a/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md +++ b/content/ja/docs/concepts/overview/working-with-objects/field-selectors.md @@ -17,7 +17,7 @@ kubectl get pods --field-selector status.phase=Running ``` {{< note >}} -フィールドセレクターは本質的にリソースの*フィルタ*となります。デフォルトでは、セレクター/フィルターが指定されていない場合は、全てのタイプのリソースが取得されます。これは、下記の2つの`kubectl`クエリが同じであることを意味します。 +フィールドセレクターは本質的にリソースの*フィルター*となります。デフォルトでは、セレクター/フィルターが指定されていない場合は、全てのタイプのリソースが取得されます。これは、下記の2つの`kubectl`クエリが同じであることを意味します。 ```shell kubectl get pods