Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Translate concepts/storage/volume-pvc-datasource in Japanese #16775

Merged
merged 16 commits into from
Nov 4, 2019
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
64 changes: 64 additions & 0 deletions content/ja/docs/concepts/storage/volume-pvc-datasource.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
---
title: CSI Volume Cloning
content_template: templates/concept
weight: 30
---

{{% capture overview %}}

{{< feature-state for_k8s_version="v1.15" state="alpha" >}}
このドキュメントではKubernetesで既存のCSIボリュームの複製についてのコンセプトを説明します。このページを読む前にあらかじめ[ボリューム](/docs/concepts/storage/volumes)についてよく理解していることが望ましいです。

この機能を使用するにはVolumePVCDataSourceのフューチャーゲートを有効にする必要があります。
Copy link
Contributor

Choose a reason for hiding this comment

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

FeatureGateって訳しますっけ?
訳す場合は フィーチャーゲート の方がいいと思います

Copy link
Contributor Author

Choose a reason for hiding this comment

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

#16554
では指摘頂いたフィーチャーゲートで翻訳していたのでそちらで修正しました


```
--feature-gates=VolumePVCDataSource=true
```


{{% /capture %}}


{{% capture body %}}

## イントロダクション

{{<glossary_tooltip text = "CSI" term_id = "csi">}}のボリューム複製機能は、ユーザーが{{<glossary_tooltip text = "ボリューム" term_id = "volume">}}の複製を作成することを示す`dataSource`フィールドで既存の{{<glossary_tooltip text = "PVC" term_id = "persistent-volume-claim">}}を指定するためのサポートを追加します。

複製は既存のKubernetesボリュームの複製として定義され、標準のボリュームと同じように使用できます。唯一の違いは、プロビジョニング時に「新しい」空のボリュームを作成するのではなく、バックエンドデバイスが指定されたボリュームの正確な複製を作成することです。

複製の実装は、Kubernetes APIの観点からは新しいPVCの作成時に既存のバインドされていないPVCをdataSourceとして指定する機能を追加するだけです。

この機能を使用する場合、ユーザーは次のことに注意する必要があります:

* 複製のサポート(`VolumePVCDataSource`)はCSIドライバーのみです。
* 複製のサポートは動的プロビジョニングのみです。
* CSIドライバーはボリューム複製機能を実装している場合としていない場合があります。
* PVCは複製先のPVCと同じ名前空間に存在する場合にのみ複製できます(複製元と複製先は同じ名前空間になければなりません)。


## プロビジョニング

複製は同じ名前空間内の既存のPVCを参照するdataSourceを追加すること以外は他のPVCと同様にプロビジョニングされます。

```yaml
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: clone-of-pvc-1
namespace: myns
spec:
capacity:
storage: 10Gi
dataSource:
kind: PersistentVolumeClaim
name: pvc-1
```

このyamlの作成結果は指定された複製元である`pvc-1`と全く同じデータを持つ`clone-of-pvc-1`という名前の新しいPVCです。
Copy link
Contributor

Choose a reason for hiding this comment

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

念の為ですが、hoge の前後にスペースがなくても正しく表示されるか確認しておいていただけると。

Copy link
Contributor Author

Choose a reason for hiding this comment

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

確認しました、問題なく表示されているようです。

CSI_Volume_Cloning_-_Kubernetes


## 使い方

新しいPVCが使用可能になると、複製されたPVCは他のPVCと同じように利用されます。またこの時点で新しく作成されたPVCは独立したオブジェクトであることが期待されます。元のdataSource PVCを考慮せず個別に利用、複製、スナップショット、削除できます。これはまた複製元が新しく作成された複製にリンクされておらず、新しく作成された複製に影響を与えずに変更または削除できることを意味します。

{{% /capture %}}
19 changes: 19 additions & 0 deletions content/ja/docs/reference/glossary/container.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
title: コンテナ
id: container
date: 2018-04-12
full_link: /docs/concepts/overview/what-is-kubernetes/#why-containers
short_description: >
軽量でポータブルなソフトウェアとそのすべての依存関係が含まれている実行可能なイメージ

aka:
tags:
- fundamental
- workload
---
軽量でポータブルなソフトウェアとそのすべての依存関係が含まれている実行可能なイメージ

<!--more-->

コンテナはアプリケーションから基盤となるホストインフラストラクチャを分離させ、さまざまなクラウドまたはOS環境での展開を容易にし、スケーリングを容易にします。

23 changes: 23 additions & 0 deletions content/ja/docs/reference/glossary/csi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
title: Container Storage Interface (CSI)
Copy link
Contributor

Choose a reason for hiding this comment

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

Container Storage Interface は訳しちゃったほうが統一感がでると思います

id: csi
date: 2018-06-25
full_link: /docs/concepts/storage/volumes/#csi
short_description: >
コンテナストレージインターフェイス(CSI)はストレージシステムをコンテナに公開するための標準インターフェイスを定義します。


aka:
tags:
- storage
---
コンテナストレージインターフェイス(CSI)はストレージシステムをコンテナに公開するための標準インターフェイスを定義します。

<!--more-->

CSI allows vendors to create custom storage plugins for Kubernetes without adding them to the Kubernetes repository (out-of-tree plugins). To use a CSI driver from a storage provider, you must first [deploy it to your cluster](https://kubernetes-csi.github.io/docs/deploying.html). You will then be able to create a {{< glossary_tooltip text="Storage Class" term_id="storage-class" >}} that uses that CSI driver.
Copy link
Contributor

Choose a reason for hiding this comment

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

削除漏れですかね


CSIはベンダーがKubernetesリポジトリにコードを追加することなく(Kubernetesリポジトリツリー外のプラグインとして)独自のストレージプラグインを作成することを可能にします。CSIドライバをストレージプロバイダから利用するには、はじめに[クラスタにCSIプラグインをデプロイする](https://kubernetes-csi.github.io/docs/deploying.html)必要があります。その後のCSIドライバーを使用するための{{< glossary_tooltip text="ストレージクラス" term_id="storage-class" >}}を作成することができます。
bells17 marked this conversation as resolved.
Show resolved Hide resolved

* [KubernetesにおけるCSIのドキュメント](/docs/concepts/storage/volumes/#csi)
* [利用可能なCSIドライバの一覧](https://kubernetes-csi.github.io/docs/drivers.html)
21 changes: 21 additions & 0 deletions content/ja/docs/reference/glossary/persistent-volume-claim.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: 永続ボリューム要求
Copy link
Contributor Author

Choose a reason for hiding this comment

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

PersistentVolumeClaim

Copy link
Contributor Author

Choose a reason for hiding this comment

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

原文だと Persistent Volume Claim となっているので 永続ボリューム要求 のままにすべきかどうか

Copy link
Contributor

Choose a reason for hiding this comment

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

スペース入っちゃっているやつですよね
訳しちゃっていいかなと思います

あと
Claims storage resources defined in a PersistentVolume so that it can be mounted as a volume in a container.
の訳ですが、ちょっと機械ぽいので

コンテナ内でボリュームとしてマウントするためのPersistentVolume内で定義されたストレージリソースを要求します。

とかでどうでしょうか (ためにでもいいかも)

id: persistent-volume-claim
date: 2018-04-12
full_link: /docs/concepts/storage/persistent-volumes/
short_description: >
ストレージ要求リソースは永続ボリュームで定義されているため、コンテナ内のボリュームとしてマウントできます。
Copy link
Contributor Author

Choose a reason for hiding this comment

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

永続ボリューム -> PersistentVolume

Copy link
Contributor Author

Choose a reason for hiding this comment

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

これは原文も PersistentVolume なので問題ないかと思われる


aka:
tags:
- core-object
- storage
---
ストレージ要求リソースは永続ボリュームで定義されているため、コンテナ内のボリュームとしてマウントできます。
Copy link
Contributor Author

Choose a reason for hiding this comment

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

永続ボリューム -> PersistentVolume

Copy link
Contributor Author

Choose a reason for hiding this comment

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

これは原文も PersistentVolume なので問題ないかと思われる


<!--more-->

Specifies the amount of storage, how the storage will be accessed (read-only, read-write and/or exclusive) and how it is reclaimed (retained, recycled or deleted). Details of the storage itself are in the PersistentVolume specification.
Copy link
Contributor

Choose a reason for hiding this comment

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

削除漏れですかね


ストレージサイズ、ストレージへのアクセス制御(読み取り専用、読み取り/書き込み、排他的)、および再利用方法(保持、リサイクル、削除)を指定します。ストレージ自体の詳細は永続ボリュームの仕様にあります。
Copy link
Contributor Author

Choose a reason for hiding this comment

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

永続ボリューム -> PersistentVolume

Copy link
Contributor Author

Choose a reason for hiding this comment

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

これは原文も PersistentVolume なので問題ないかと思われる


20 changes: 20 additions & 0 deletions content/ja/docs/reference/glossary/persistent-volume.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
title: 永続ボリューム
Copy link
Contributor Author

Choose a reason for hiding this comment

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

PersistentVolume

Copy link
Contributor Author

Choose a reason for hiding this comment

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

原文だと Persistent Volume となってるのでどうすべきか

id: persistent-volume
date: 2018-04-12
full_link: /docs/concepts/storage/persistent-volumes/
short_description: >
クラスター内のストレージの一部を示すAPIオブジェクトで、個々のPodのライフサイクルを超えて接続する一般的でプラグ可能なリソースとして利用可能です。

aka:
tags:
- core-object
- storage
---
クラスター内のストレージの一部を示すAPIオブジェクトで、個々の{{< glossary_tooltip text="Pod" term_id="pod" >}}のライフサイクルを超えて接続する一般的でプラグ可能なリソースとして利用可能です。
Copy link
Contributor

Choose a reason for hiding this comment

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

プラグ可能な は表現を変えたほうが良いと思います。プラグイン形式で利用可能な?プラガブルな?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

こちらですが
#16775 (comment)
に合わせる形で修正してみました

Copy link
Contributor

Choose a reason for hiding this comment

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

pluggable って難しいですよね
あとここでいう as a general も一般的にというよりは、いわゆる 特別なことしなくても普通に使えるよ っていうことですよね
そして beyond も直訳だと変になりますよね

ちょっと意訳して

通常利用可能で、個々のPodのライフサイクルの先にあるプラグイン形式のリソースです。

とかいかがでしょうか

Copy link
Contributor Author

Choose a reason for hiding this comment

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

ありがとうございます。

クラスター内のストレージの一部を示すAPIオブジェクトで

の部分含めて頂いた翻訳と合わせて修正してみました

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
Contributor Author

Choose a reason for hiding this comment

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

@inductor 修正漏れすみませんでした。。修正したのでご確認お願いします 🙏


<!--more-->

永続ボリューム(PV)はストレージの利用方法からストレージの提供方法の詳細を抽象化するAPIを提供します。
Copy link
Contributor Author

Choose a reason for hiding this comment

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

永続ボリューム -> PersistentVolume

PVはストレージを事前に作成できるシナリオで直接使用されます(静的プロビジョニング)。
オンデマンドストレージ(動的プロビジョニング)を必要とするシナリオでは、代わりに永続ボリューム要求(PVC)が使用されます。
Copy link
Contributor Author

Choose a reason for hiding this comment

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

永続ボリューム要求->PersistentVolumeClaim

22 changes: 22 additions & 0 deletions content/ja/docs/reference/glossary/storage-class.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
---
title: ストレージクラス
bells17 marked this conversation as resolved.
Show resolved Hide resolved
id: storageclass
date: 2018-04-12
full_link: /docs/concepts/storage/storage-classes
short_description: >
ストレージクラスは管理者が利用可能なさまざまなストレージタイプを記述する方法を提供します。
bells17 marked this conversation as resolved.
Show resolved Hide resolved

aka:
tags:
- core-object
- storage
---
ストレージクラスは管理者が利用可能なさまざまなストレージタイプを記述する方法を提供します。
bells17 marked this conversation as resolved.
Show resolved Hide resolved

<!--more-->

StorageClasses can map to quality-of-service levels, backup policies, or to arbitrary policies determined by cluster administrators. Each StorageClass contains the fields `provisioner`, `parameters`, and `reclaimPolicy`, which are used when a {{< glossary_tooltip text="Persistent Volume" term_id="persistent-volume" >}} belonging to the class needs to be dynamically provisioned. Users can request a particular class using the name of a StorageClass object.
Copy link
Contributor

Choose a reason for hiding this comment

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

削除漏れですかね


ストレージクラスはサービス品質レベル、バックアップポリシー、クラスター管理者が決定した任意のポリシーにマッピングできます。
Copy link
Contributor

Choose a reason for hiding this comment

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

悩ましいところですが、ここは StorageClasses のままでいいと思います(次の行も)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@makocchi-git すみません、こちら

ストレージクラスはサービス品質レベル、バックアップポリシー、クラスター管理者が決定した任意のポリシーにマッピングできます。

各ストレージクラスには`provisioner`、` parameters`、`reclaimPolicy`フィールドが含まれています。これらは、対象のストレージクラスの{{< glossary_tooltip text="永続ボリューム" term_id="persistent-volume" >}}を動的プロビジョニングする必要がある場合に使用されます。ユーザーはストレージクラスオブジェクトの名前を使用して特定のストレージクラスを要求できます。

の部分のストレージクラスをStorageClassesに修正、で良いでしょうか?
(それより上の部分のタイトルなどはストレージクラスのままという理解であってますか?)

それとStorageClassesは複数形となっていますが、単数形StorageClasseの方が良かったりするでしょうか?

Copy link
Contributor

Choose a reason for hiding this comment

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

うわー すいませんでした
確かに複数形ですね
訳しちゃいましょう

Copy link
Contributor Author

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.

個人的にわりとこれ系は単数に変えてStorageClassにしちゃうんですが、それだとまずいですかね。@makocchi-git

Copy link
Contributor

Choose a reason for hiding this comment

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

まずくはないと思いますね
むしろ自分はそう見えちゃってたし
もう決めの問題ですね

何度も意見変わって申し訳ないですが、単数形の StorageClass にしちゃいましょう!

Copy link
Member

Choose a reason for hiding this comment

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

はい。文意を汲み取る限りStorageClassたちという意味だと思うので、日本語的にはStorageClassで良いと思います。

bells17 marked this conversation as resolved.
Show resolved Hide resolved

各ストレージクラスには`provisioner`、` parameters`、`reclaimPolicy`フィールドが含まれています。これらは、対象のストレージクラスの{{< glossary_tooltip text="永続ボリューム" term_id="persistent-volume" >}}を動的プロビジョニングする必要がある場合に使用されます。ユーザーはストレージクラスオブジェクトの名前を使用して特定のストレージクラスを要求できます。
bells17 marked this conversation as resolved.
Show resolved Hide resolved
18 changes: 18 additions & 0 deletions content/ja/docs/reference/glossary/volume.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
---
title: ボリューム
id: volume
date: 2018-04-12
full_link: /docs/concepts/storage/volumes/
short_description: >
ポッド内のコンテナからアクセス可能なデータを含むディレクトリ。

aka:
tags:
- core-object
- fundamental
---
{{< glossary_tooltip text="ポッド" term_id="pod" >}}内のコンテナからアクセス可能なデータを含むディレクトリ。

<!--more-->

Kubernetesボリュームはボリュームを含む{{< glossary_tooltip text="ポッド" term_id="pod" >}}が存在する限り有効です。そのためボリュームは{{< glossary_tooltip text="ポッド" term_id="pod" >}}内で実行されるすべての{{< glossary_tooltip text="コンテナ" term_id="container" >}}よりも長持ちし、{{< glossary_tooltip text="コンテナ" term_id="container" >}}の再起動後もデータは保持されます。