Skip to content

Commit

Permalink
Translate concepts/storage/volume-pvc-datasource in Japanese (#16775)
Browse files Browse the repository at this point in the history
* Translate concepts/storage/volume-pvc-datasource in Japanese

* Remove original English contents(forgot to remove)

* Container Storage Interface -> コンテナストレージインターフェイス

* フューチャーゲート -> フィーチャーゲート

* Improved a translate to more natural expression

* Update content/ja/docs/reference/glossary/csi.md

Co-Authored-By: inductor <[email protected]>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <[email protected]>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <[email protected]>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <[email protected]>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <[email protected]>

* Update content/ja/docs/reference/glossary/storage-class.md

Co-Authored-By: inductor <[email protected]>

* Improved a translate to more natural expression

* Remove an unnecessary line break

* Improved some translate words to natural sentence

* Improved translate

* Fix translate
  • Loading branch information
bells17 authored and k8s-ci-robot committed Nov 4, 2019
1 parent 6216d15 commit 17e046a
Show file tree
Hide file tree
Showing 7 changed files with 180 additions and 0 deletions.
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のフィーチャーゲートを有効にする必要があります。

```
--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です。

## 使い方

新しい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環境での展開を容易にし、スケーリングを容易にします。

21 changes: 21 additions & 0 deletions content/ja/docs/reference/glossary/csi.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
title: コンテナストレージインターフェイス(CSI)
id: csi
date: 2018-06-25
full_link: /docs/concepts/storage/volumes/#csi
short_description: >
コンテナストレージインターフェイス(CSI)はストレージシステムをコンテナに公開するための標準インターフェイスを定義します。
aka:
tags:
- storage
---
コンテナストレージインターフェイス(CSI)はストレージシステムをコンテナに公開するための標準インターフェイスを定義します。

<!--more-->

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

* [KubernetesにおけるCSIのドキュメント](/docs/concepts/storage/volumes/#csi)
* [利用可能なCSIドライバの一覧](https://kubernetes-csi.github.io/docs/drivers.html)
19 changes: 19 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,19 @@
---
title: 永続ボリューム要求
id: persistent-volume-claim
date: 2018-04-12
full_link: /docs/concepts/storage/persistent-volumes/
short_description: >
コンテナ内でボリュームとしてマウントするためにPersistentVolume内で定義されたストレージリソースを要求します。
aka:
tags:
- core-object
- storage
---
コンテナ内でボリュームとしてマウントするためにPersistentVolume内で定義されたストレージリソースを要求します。

<!--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: 永続ボリューム
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" >}}のライフサイクルの先にあるプラグイン形式のリソースです。

<!--more-->

PersistentVolume(PV)はストレージの利用方法からストレージの提供方法の詳細を抽象化するAPIを提供します。
PVはストレージを事前に作成できるシナリオで直接使用されます(静的プロビジョニング)。
オンデマンドストレージ(動的プロビジョニング)を必要とするシナリオでは、代わりにPersistentVolumeClaims(PVC)が使用されます。
19 changes: 19 additions & 0 deletions content/ja/docs/reference/glossary/storage-class.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
title: StorageClass
id: storageclass
date: 2018-04-12
full_link: /docs/concepts/storage/storage-classes
short_description: >
StorageClassは管理者が利用可能なさまざまなストレージタイプを記述する方法を提供します。
aka:
tags:
- core-object
- storage
---
StorageClassは管理者が利用可能なさまざまなストレージタイプを記述する方法を提供します。

<!--more-->

StorageClassはサービス品質レベル、バックアップポリシー、クラスター管理者が決定した任意のポリシーにマッピングできます。
各StorageClassには`provisioner`` parameters``reclaimPolicy`フィールドが含まれています。これらは、対象のStorageClassの{{< glossary_tooltip text="PersistentVolume" term_id="persistent-volume" >}}を動的プロビジョニングする必要がある場合に使用されます。ユーザーはStorageClassオブジェクトの名前を使用して特定のStorageClassを要求できます。
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" >}}の再起動後もデータは保持されます。

0 comments on commit 17e046a

Please sign in to comment.