Garage¶

Змонтуйте бакет у кластері Garage — легкому S3-сховищі для самостійного розгортання — як диск Windows.

Перш ніж почати¶

Підготуйте заздалегідь:

URL-адресу кінцевої точки S3 вашого кластера Garage.
Пару ключів Ідентифікатор ключа (Access Key ID) і Секретний ключ доступу (Secret Access Key) з доступом до цільового бакета.
Регіон, налаштований для кластера (у Garage за умовчанням — garage).

Де отримати ключі — на комп'ютері, з якого адмініструється кластер:

garage key create raidrive-key
garage bucket allow --read --write YOUR-BUCKET --key raidrive-key

Перша команда виводить Key ID і Secret key.

Довідка від Garage

Натисніть Додати на панелі інструментів.
Виберіть Enterprise → Garage.
Введіть URL-адресу кінцевої точки, Регіон, Ідентифікатор ключа та Секретний ключ доступу, потім натисніть кнопку Оновити поруч із полем бакета.
Виберіть бакет і натисніть Підключити.

Введення бакета вручну

Якщо вашому ключу заборонено отримувати список бакетів, установіть прапорець ліворуч від поля бакета й введіть назву бакета безпосередньо.

Параметр	Опис	За умовчанням
Кінцева точка	URL-адреса S3 API Garage	—
Регіон	Значення регіону кластера (потрібне для підписування запитів)	—
Ідентифікатор ключа / Секретний ключ доступу	Пара ключів Garage	—
Бакет	Бакет для монтування (зі списку або введений вручну)	—
Лише читання	Блокує запис на змонтований диск	вимк.

Підключення використовують адресацію у стилі шляху (path-style), а приватні або самопідписані сертифікати TLS приймаються — це підходить для розгортань у локальній мережі та домашніх лабораторіях (homelab).

Симптом	Причина	Рішення
Помилки підпису	Регіон не відповідає конфігурації кластера	Установіть у полі Регіон значення `s3_region` кластера
Список бакетів порожній	Ключу не надано доступ до бакета	Надайте ключу доступ командою `garage bucket allow` або введіть бакет вручну