Skip to content

Commit f8db37e

Browse files
committed
de: add missing guides (access-token, bucket create/delete, object upload/delete, mc); copy guide images; initial placeholder coverage planned
1 parent 360a311 commit f8db37e

11 files changed

+334
-0
lines changed

docs/de/guide/access-token.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title: "Verwaltung von RustFS‑Zugriffsschlüsseln"
3+
description: "Erstellen, Verwenden und Löschen von Zugriffsschlüsseln in RustFS"
4+
---
5+
6+
# Zugriffsschlüssel
7+
8+
RustFS‑Zugriffsschlüssel sind zentrale Anmeldeinformationen, um Identitäten zu authentifizieren und Aktionen zu autorisieren. Sie sind besonders in API‑ und SDK‑Szenarien nützlich. Dieses Kapitel beschreibt das Erstellen und Löschen von Zugriffsschlüsseln.
9+
10+
Voraussetzungen:
11+
12+
- Eine verfügbare RustFS‑Instanz. Siehe [Installationshandbuch](../../de/installation/index.md).
13+
14+
## Zugriffsschlüssel erstellen
15+
16+
1. Melden Sie sich an der RustFS UI‑Konsole an.
17+
1. Wählen Sie in der linken Navigation „Zugriffsschlüssel“.
18+
1. Klicken Sie oben rechts auf „Zugriffsschlüssel hinzufügen“.
19+
1. Geben Sie „Ablaufzeit, Name und Beschreibung“ ein und klicken Sie auf „Senden“.
20+
1. (Optional, aber empfohlen) Wählen Sie auf der Schlüssel‑Detailseite „Kopieren“ oder „Exportieren“, um den Schlüssel sicher aufzubewahren.
21+
22+
![access key list page](images/access_token_creation.png)
23+
24+
## Zugriffsschlüssel löschen
25+
26+
1. Melden Sie sich an der RustFS UI‑Konsole an.
27+
1. Wählen Sie in der linken Navigation „Zugriffsschlüssel“.
28+
1. Wählen Sie den zu löschenden Schlüssel aus.
29+
1. Klicken Sie rechts auf „Löschen“ oder oben rechts auf „Ausgewählte löschen“.
30+
31+
![access key deletion](images/access_token_deletion.png)
Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
---
2+
title: "Verwaltung von RustFS‑Buckets"
3+
description: "Erstellen und Löschen von Buckets in RustFS"
4+
---
5+
6+
# RustFS‑Buckets
7+
8+
Ein Bucket ist der logische Basis‑Container in RustFS zur Organisation und Verwaltung von Daten. Jeder Bucket hat einen eindeutigen Namen und kann mehrere Objekte enthalten. Buckets lassen sich über die RustFS‑UI, `mc` (MinIO Client) oder per API verwalten (erstellen, löschen, Upload/Download usw.).
9+
10+
## Bucket erstellen
11+
12+
Voraussetzungen:
13+
14+
- Eine verfügbare RustFS‑Instanz (siehe ../../installation/index.md).
15+
16+
## In der RustFS‑UI erstellen
17+
18+
1. Melden Sie sich an der RustFS UI‑Konsole an.
19+
1. Klicken Sie auf der Startseite oben links auf „Bucket erstellen“.
20+
1. Geben Sie den Bucket‑Namen ein und klicken Sie auf „Erstellen“.
21+
22+
![bucket creation](images/bucket-creation-by-ui.png)
23+
24+
### Mit `mc` erstellen
25+
26+
> Siehe [`mc`‑Leitfaden](../mc.md) zur Installation und Konfiguration.
27+
28+
```
29+
# creat rustfs bucket
30+
mc mb rustfs/bucket-creation-by-mc
31+
Bucket created successfully `rustfs/bucket-creation-by-mc`.
32+
33+
# confirm bucket creation
34+
mc ls rustfs/bucket-creation-by-mc
35+
```
36+
37+
### Per API erstellen
38+
39+
```
40+
PUT /{bucketName} HTTP/1.1
41+
```
42+
43+
Beispiel:
44+
45+
```
46+
curl --location --request PUT 'http://12.34.56.78:9000/bucket-creation-by-api' \
47+
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
48+
--header 'X-Amz-Date: 20250801T023519Z' \
49+
--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=c2fb2ba5199a30ebcfa9976d0f35000ba274da3701327957e84ea0f3920288f2'
50+
```
51+
52+
Sie können in der UI bestätigen, dass `bucket-creation-by-api` erfolgreich erstellt wurde.
53+
54+
## Bucket löschen
55+
56+
Achtung: Das Löschen eines Buckets kann Anwendungen beeinträchtigen, die ihn verwenden. Sichern Sie Daten und stellen Sie sicher, dass der Bucket nicht mehr benötigt wird.
57+
58+
### In der RustFS‑UI löschen
59+
60+
1. Melden Sie sich an der RustFS UI‑Konsole an.
61+
1. Wählen Sie auf der Startseite den zu löschenden Bucket aus.
62+
1. Klicken Sie ganz rechts auf „Löschen“.
63+
1. Bestätigen Sie im Dialog mit „Bestätigen“.
64+
65+
![bucket deletion](images/bucket-deletion-on-ui.png)
66+
67+
### Mit `mc` löschen
68+
69+
> Siehe [`mc`‑Leitfaden](../mc.md).
70+
71+
```
72+
# delete bucket
73+
mc rb rustfs/bucket-creation-by-mc
74+
Removed `rustfs/bucket-creation-by-mc` successfully.
75+
76+
# confirm bucket deletion
77+
mc ls rustfs/bucket-creation-by-mc
78+
mc: <ERROR> Unable to list folder. Bucket `bucket-creation-by-mc` does not exist.
79+
```
80+
81+
### Per API löschen
82+
83+
```
84+
DELETE /{bucketName} HTTP/1.1
85+
```
86+
87+
Beispiel:
88+
89+
```
90+
curl --location --request DELETE 'http://12.34.56.78:9000/bucket-creation-by-api' \
91+
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
92+
--header 'X-Amz-Date: 20250801T024406Z' \
93+
--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=host;x-amz-content-sha256;x-amz-date, Signature=d0f6addf09fffd7eef75191e9d3209bb7188e6b004e9707238fc60ad7033edae'
94+
```
95+
96+
In der RustFS‑UI können Sie bestätigen, dass `bucket-creation-by-api` gelöscht wurde.
139 KB
Loading
65.3 KB
Loading
219 KB
Loading
342 KB
Loading
141 KB
Loading
Lines changed: 103 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,103 @@
1+
---
2+
title: "Verwaltung von RustFS‑Objekten"
3+
description: "Erstellen (Upload) und Löschen von Objekten"
4+
---
5+
6+
# RustFS‑Objekte
7+
8+
Ein Objekt ist die Basiseinheit der Speicherung in RustFS. Es enthält Daten, Metadaten und einen eindeutigen Bezeichner (Object Key). Dieses Kapitel zeigt die Objektverwaltung am Beispiel von Datei‑Upload und ‑Löschung.
9+
10+
> Zu objektbezogenen Begriffen siehe [Grundlagen](../../concepts/glossary.md).
11+
12+
## Objekt erstellen
13+
14+
Voraussetzungen:
15+
16+
- Eine verfügbare RustFS‑Instanz (siehe ../../installation/index.md).
17+
18+
Erstellen Sie zunächst einen [Bucket](bucket-create-and-delete.md) und laden Sie anschließend eine Datei in diesen Bucket hoch. Das kann über die UI, `mc` oder die API erfolgen.
19+
20+
### Upload über die RustFS‑UI
21+
22+
1. Melden Sie sich an der RustFS UI‑Konsole an.
23+
1. Wählen Sie den Ziel‑Bucket aus.
24+
1. Rechts oben auf der Bucket‑Seite wählen Sie „Neuer Ordner“, „Neue Datei“ oder „Datei/Ordner hochladen“.
25+
1. Für lokale Uploads klicken Sie auf „Datei/Ordner hochladen“, wählen die lokalen Elemente aus und klicken auf „Upload starten“.
26+
27+
![object creation from ui](images/upload_file_from_ui.png)
28+
29+
Nach dem Upload können Sie Details des Objekts einsehen.
30+
31+
![object details info](images/object_details_info.png)
32+
33+
### Upload mit `mc`
34+
35+
> Siehe [`mc`‑Leitfaden](../mc.md).
36+
37+
```
38+
# upload file
39+
mc cp 1.txt rustfs/bucket-creation-by-mc
40+
/tmp/1.txt: 13 B / 13 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 61 B/s 0s%
41+
42+
# confirm file uploaded
43+
mc ls rustfs/bucket-creation-by-mc
44+
[2025-08-01 10:01:08 CST] 13B 1.txt
45+
```
46+
47+
### Upload per API
48+
49+
```
50+
PUT /{bucketName}/{objectName} HTTP/1.1
51+
```
52+
53+
Beispiel:
54+
55+
```
56+
curl --location --request PUT 'http://12.34.56.78:9000/bucket-creation-by-api/password.txt' \
57+
--header 'Content-Type: text/plain' \
58+
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
59+
--header 'X-Amz-Date: 20250801T024840Z' \
60+
--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-date, Signature=b7d8dc29ee34dfdf1f3e9e8e069892a8936f478586e7a2c90cf34f5b86d3a2dc' \
61+
--data-binary '@/path/to/password.txt'
62+
```
63+
64+
## Objekt löschen
65+
66+
Das Löschen kann über die UI, `mc` oder die API erfolgen. Löschen Sie z. B. die oben erstellte Datei.
67+
68+
## Löschung über die RustFS‑UI
69+
70+
1. Melden Sie sich an der RustFS UI‑Konsole an.
71+
1. Wählen Sie den Bucket, der die Datei enthält.
72+
1. Wählen Sie die zu löschende Datei aus.
73+
1. Klicken Sie rechts oben auf „Ausgewählte löschen“ und bestätigen Sie im Dialog.
74+
75+
![object deletion from ui](images/delete_file_from_ui.png)
76+
77+
### Löschen mit `mc`
78+
79+
```
80+
# delete file
81+
mc rm rustfs/bucket-creation-by-mc/1.txt
82+
Removed `rustfs/bucket-creation-by-mc/1.txt`.
83+
84+
# confirm deletion
85+
mc ls rustfs/bucket-creation-by-mc/1.txt
86+
```
87+
88+
### Löschen per API
89+
90+
```
91+
DELETE /{bucketName}/{objectName} HTTP/1.1
92+
```
93+
94+
Beispiel:
95+
96+
```
97+
curl --location --request DELETE 'http://12.34.56.78:9000/bucket-creation-by-api/password.txt' \
98+
--header 'Content-Type: text/plain' \
99+
--header 'X-Amz-Content-Sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855' \
100+
--header 'X-Amz-Date: 20250801T030822Z' \
101+
--header 'Authorization: AWS4-HMAC-SHA256 Credential=H4xcBZKQfvJjEnk3zp1N/20250801/cn-east-1/s3/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-content-sha256;x-amz-date, Signature=1ee63bb0b699598602b2fdbd013e355a57bcb9991307a8ad41f6512e8afebf3a' \
102+
--data-binary '@/Users/jhma/Desktop/password.txt'
103+
```
189 KB
Loading
173 KB
Loading

0 commit comments

Comments
 (0)