Skip to content

Commit b7d6cdb

Browse files
KobayashiD27KobayashiD27
committed
Translate docs/concepts/storage/volume-snapshots/ into Japanese
1 parent 60887ae commit b7d6cdb

File tree

2 files changed

+180
-1
lines changed

2 files changed

+180
-1
lines changed

‎content/ja/docs/concepts/storage/persistent-volumes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -678,7 +678,7 @@ Podにrawブロックデバイスを追加する場合は、マウントパス
678678
アルファリリースでは、静的にプロビジョニングされたボリュームのみがサポートされます。管理者は、rawブロックデバイスを使用する場合、これらの値を考慮するように注意する必要があります。
679679
{{< /note >}}
680680

681-
## ボリュームのスナップショットとスナップショットからのボリュームの復元のサポート
681+
## ボリュームのスナップショットとスナップショットからのボリュームの復元のサポート {#volume-snapshot-and-restore-volume-from-snapshot-support}
682682

683683
{{< feature-state for_k8s_version="v1.17" state="beta" >}}
684684

‎content/ja/docs/concepts/storage/volume-snapshots.md

Lines changed: 179 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,179 @@
1+
---
2+
title: Volumeのスナップショット
3+
content_type: concept
4+
weight: 60
5+
---
6+
7+
<!-- overview -->
8+
9+
Kubernetesでは、*VolumeSnapshot*はストレージシステム上のボリュームのスナップショットを表します。このドキュメントは、Kubernetes[永続ボリューム](/ja/docs/concepts/storage/persistent-volumes/)に既に精通していることを前提としています。
10+
11+
<!-- body -->
12+
13+
## 概要 {#introduction}
14+
15+
APIリソース`PersistentVolume`と`PersistentVolumeClaim`を使用してユーザーと管理者にボリュームをプロビジョニングする方法と同様に、`VolumeSnapshotContent`と`VolumeSnapshot`APIリソースは、ユーザーと管理者のボリュームスナップショットを作成するために提供されます。
16+
17+
`VolumeSnapshotContent`は、管理者によってプロビジョニングされたクラスター内のボリュームから取得されたスナップショットです。PersistentVolumeがクラスターリソースであるように、これはクラスターのリソースです。
18+
19+
`VolumeSnapshot`は、ユーザーによるボリュームのスナップショットの要求です。PersistentVolumeClaimに似ています。
20+
21+
`VolumeSnapshotClass`を使用すると、`VolumeSnapshot`に属するさまざまな属性を指定できます。これらの属性は、ストレージシステム上の同じボリュームから取得されたスナップショット間で異なる場合があるため、`PersistentVolumeClaim`の同じ`StorageClass`を使用して表現することはできません。
22+
23+
ボリュームスナップショットは、完全に新しいボリュームを作成することなく、特定の時点でボリュームの内容をコピーするための標準化された方法をKubernetesユーザーに提供します。この機能により、たとえばデータベース管理者は、編集または削除の変更を実行する前にデータベースをバックアップできます。
24+
25+
この機能を使用する場合、ユーザーは次のことに注意する必要があります。
26+
27+
- APIオブジェクト`VolumeSnapshot`、`VolumeSnapshotContent`、および`VolumeSnapshotClass`は{{< glossary_tooltip term_id="CustomResourceDefinition" text="CRD" >}}であり、コアAPIの一部ではありません。
28+
- `VolumeSnapshot`のサポートは、CSIドライバーでのみ利用できます。
29+
- `VolumeSnapshot`の展開プロセスの一環として、Kubernetesチームは、コントロールプレーンに展開されるスナップショットコントローラーと、CSIドライバーと共に展開されるcsi-snapshotterと呼ばれるサイドカーヘルパーコンテナーを提供します。`VolumeSnapshot`および`VolumeSnapshotContent`オブジェクトを管理し、`VolumeSnapshotContent`オブジェクトの作成と削除を担当します。サイドカーcsi-snapshotterは、`VolumeSnapshotContent`オブジェクトを監視し、CSIエンドポイントに対して`CreateSnapshot`および`DeleteSnapshot`操作をトリガーします。
30+
-スナップショットオブジェクトの厳密な検証を提供するvalidation Webhookサーバーもあります。これは、CSIドライバーではなく、スナップショットコントローラーおよびCRDと共にKubernetesディストリビューションによってインストールする必要があります。スナップショット機能が有効になっているすべてのKubernetesクラスターにインストールする必要があります。
31+
- CSIドライバーは、ボリュームスナップショット機能を実装している場合と実装していない場合があります。ボリュームスナップショットのサポートを提供するCSIドライバーは、csi-snapshotterを使用する可能性があります。詳細については、[CSIドライバーのドキュメント](https://kubernetes-csi.github.io/docs/)を参照してください。
32+
- CRDとスナップショットコントローラーのインストールは、Kubernetesディストリビューションの責任です。
33+
34+
## ボリュームスナップショットとボリュームスナップショットのコンテンツのライフサイクル
35+
36+
`VolumeSnapshotContents`はクラスター内のリソースです。`VolumeSnapshots`は、これらのリソースに対するリクエストです。`VolumeSnapshotContents`と`VolumeSnapshots`の間の相互作用は、次のライフサイクルに従います。
37+
38+
### プロビジョニングボリュームのスナップショット
39+
40+
スナップショットをプロビジョニングするには、事前プロビジョニングと動的プロビジョニングの2つの方法があります。
41+
42+
#### 事前プロビジョニング{#static}
43+
44+
クラスター管理者は、多数の`VolumeSnapshotContents`を作成します。それらは、クラスターユーザーが使用できるストレージシステム上の実際のボリュームスナップショットの詳細を保持します。それらはKubernetesAPIに存在し、消費することができます。
45+
46+
#### 動的プロビジョニング
47+
48+
既存のスナップショットを使用する代わりに、スナップショットをPersistentVolumeClaimから動的に取得するように要求できます。[VolumeSnapshotClass](/ja/docs/concepts/storage/volume-snapshot-classes/)は、スナップショットを作成するときに使用するストレージプロバイダー固有のパラメーターを指定します。
49+
50+
### バインディング
51+
52+
スナップショットコントローラーは、事前プロビジョニングされたシナリオと動的にプロビジョニングされたシナリオの両方で、適切な`VolumeSnapshotContent`オブジェクトを使用した`VolumeSnapshot`オブジェクトのバインディングを処理します。バインディングは1対1のマッピングです。
53+
事前プロビジョニングされたバインディングの場合、要求されたVolumeSnapshotContentオブジェクトが作成されるまで、VolumeSnapshotはバインドされないままになります。
54+
55+
### スナップショットソース保護としてのPersistentVolumeClaim
56+
57+
この保護の目的は、スナップショットがシステムから取得されている間、使用中の{{< glossary_tooltip text="PersistentVolumeClaim" term_id="persistent-volume-claim" >}}APIオブジェクトがシステムから削除されないようにすることです(これにより、データが失われる可能性があります）。
58+
59+
PersistentVolumeClaimのスナップショットが作成されている間、そのPersistentVolumeClaimは使用中です。スナップショットソースとしてアクティブに使用されているPersistentVolumeClaim APIオブジェクトを削除しても、PersistentVolumeClaimオブジェクトはすぐには削除されません。代わりに、PersistentVolumeClaimオブジェクトの削除は、スナップショットがReadyToUseになるか中止されるまで延期されます。
60+
61+
### 削除
62+
63+
削除は`VolumeSnapshot`オブジェクトの削除によってトリガーされ、`DeletionPolicy`に従います。`DeletionPolicy`が`Delete`の場合、基になるストレージスナップショットは`VolumeSnapshotContent`オブジェクトとともに削除されます。`DeletionPolicy`が`Retain`の場合、基になるスナップショットと`VolumeSnapshotContent`の両方が残ります。
64+
65+
## ボリュームスナップショット
66+
67+
各VolumeSnapshotには、仕様とステータスが含まれています。
68+
69+
```yaml
70+
apiVersion: snapshot.storage.k8s.io/v1
71+
kind: VolumeSnapshot
72+
metadata:
73+
name: new-snapshot-test
74+
spec:
75+
volumeSnapshotClassName: csi-hostpath-snapclass
76+
source:
77+
persistentVolumeClaimName: pvc-test
78+
```
79+
80+
`persistentVolumeClaimName`は、スナップショットのPersistentVolumeClaimデータソースの名前です。このフィールドは、スナップショットを動的にプロビジョニングするために必要です。
81+
ボリュームスナップショットは、属性`volumeSnapshotClassName`を使用して[VolumeSnapshotClass](/ja/docs/concepts/storage/volume-snapshot-classes/)の名前を指定することにより、特定のクラスを要求できます。何も設定されていない場合、利用可能な場合はデフォルトのクラスが使用されます。
82+
事前プロビジョニングされたスナップショットの場合、次の例に示すように、スナップショットのソースとして`volumeSnapshotContentName`を指定する必要があります。事前プロビジョニングされたスナップショットには、`volumeSnapshotContentName`ソースフィールドが必要です。
83+
84+
```yaml
85+
apiVersion: snapshot.storage.k8s.io/v1
86+
kind: VolumeSnapshot
87+
metadata:
88+
name: test-snapshot
89+
spec:
90+
source:
91+
volumeSnapshotContentName: test-content
92+
```
93+
94+
## ボリュームスナップショットコンテンツ
95+
96+
各VolumeSnapshotContentには、仕様とステータスが含まれています。動的プロビジョニングでは、スナップショット共通コントローラーが`VolumeSnapshotContent`オブジェクトを作成します。以下に例を示します。
97+
98+
```yaml
99+
apiVersion: snapshot.storage.k8s.io/v1
100+
kind: VolumeSnapshotContent
101+
metadata:
102+
name: snapcontent-72d9a349-aacd-42d2-a240-d775650d2455
103+
spec:
104+
deletionPolicy: Delete
105+
driver: hostpath.csi.k8s.io
106+
source:
107+
volumeHandle: ee0cfb94-f8d4-11e9-b2d8-0242ac110002
108+
sourceVolumeMode: Filesystem
109+
volumeSnapshotClassName: csi-hostpath-snapclass
110+
volumeSnapshotRef:
111+
name: new-snapshot-test
112+
namespace: default
113+
uid: 72d9a349-aacd-42d2-a240-d775650d2455
114+
```
115+
116+
`volumeHandle`は、ストレージバックエンドで作成され、ボリュームの作成中にCSIドライバーによって返されるボリュームの一意の識別子です。このフィールドは、スナップショットを動的にプロビジョニングするために必要です。これは、スナップショットのボリュームソースを指定します。
117+
事前プロビジョニングされたスナップショットの場合、(クラスター管理者として)次のように`VolumeSnapshotContent`オブジェクトを作成する必要があります。
118+
119+
```yaml
120+
apiVersion: snapshot.storage.k8s.io/v1
121+
kind: VolumeSnapshotContent
122+
metadata:
123+
name: new-snapshot-content-test
124+
spec:
125+
deletionPolicy: Delete
126+
driver: hostpath.csi.k8s.io
127+
source:
128+
snapshotHandle: 7bdd0de3-aaeb-11e8-9aae-0242ac110002
129+
sourceVolumeMode: Filesystem
130+
volumeSnapshotRef:
131+
name: new-snapshot-test
132+
namespace: default
133+
```
134+
135+
`snapshotHandle`は、ストレージバックエンドで作成されたボリュームスナップショットの一意の識別子です。このフィールドは、事前プロビジョニングされたスナップショットに必要です。この`VolumeSnapshotContent`が表すストレージシステムのCSIスナップショットIDを指定します。
136+
137+
`sourceVolumeMode`は、スナップショットが作成されるボリュームのモードです。`sourceVolumeMode`フィールドの値は、`Filesystem`または`Block`のいずれかです。ソースボリュームモードが指定されていない場合、Kubernetesはスナップショットをソースボリュームのモードが不明であるかのように扱います。
138+
139+
`volumeSnapshotRef`は、対応する`VolumeSnapshot`の参照です。`VolumeSnapshotContent`が事前プロビジョニングされたスナップショットとして作成されている場合、`volumeSnapshotRef`で参照される`VolumeSnapshot`がまだ存在しない可能性があることに注意してください。
140+
141+
## スナップショットのボリュームモードの変換 {#convert-volume-mode}
142+
143+
クラスターにインストールされている`VolumeSnapshots`APIが`sourceVolumeMode`フィールドをサポートしている場合、APIには、権限のないユーザーがボリュームのモードを変換するのを防ぐ機能があります。
144+
145+
クラスターにこの機能の機能があるかどうかを確認するには、次のコマンドを実行します。
146+
147+
```yaml
148+
$ kubectl get crd volumesnapshotcontent -o yaml
149+
```
150+
151+
ユーザーが既存の`VolumeSnapshot`から`PersistentVolumeClaim`を作成できるようにしたいが、ソースとは異なるボリュームモードを使用する場合は、`VolumeSnapshot`に対応する`VolumeSnapshotContent`にアノテーション`snapshot.storage.kubernetes.io/allowVolumeModeChange: "true"`を追加する必要があります。
152+
153+
事前プロビジョニングされたスナップショットの場合、クラスター管理者が`Spec.SourceVolumeMode`を入力する必要があります。
154+
155+
この機能を有効にした`VolumeSnapshotContent`リソースの例は次のようになります。
156+
157+
```yaml
158+
apiVersion: snapshot.storage.k8s.io/v1
159+
kind: VolumeSnapshotContent
160+
metadata:
161+
name: new-snapshot-content-test
162+
annotations:
163+
- snapshot.storage.kubernetes.io/allowVolumeModeChange: "true"
164+
spec:
165+
deletionPolicy: Delete
166+
driver: hostpath.csi.k8s.io
167+
source:
168+
snapshotHandle: 7bdd0de3-aaeb-11e8-9aae-0242ac110002
169+
sourceVolumeMode: Filesystem
170+
volumeSnapshotRef:
171+
name: new-snapshot-test
172+
namespace: default
173+
```
174+
175+
## スナップショットからのボリュームのプロビジョニング
176+
177+
`PersistentVolumeClaim`オブジェクトの*dataSource*フィールドを使用して、スナップショットからのデータが事前に取り込まれた新しいボリュームをプロビジョニングできます。
178+
179+
詳細については、[ボリュームのスナップショットとスナップショットからのボリュームの復元](/docs/concepts/storage/persistent-volumes/#volume-snapshot-and-restore-volume-from-snapshot-support)を参照してください。

0 commit comments

Comments
 (0)