Garage Operations

Manage S3-compatible object storage operations for self-hosted Garage clusters.

9|3|Updated Apr 16, 2024
One-click install
npx skills add https://github.com/keiretsu-labs/kubernetes-manifests --skill garage-operations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Garage Operations
Source: https://github.com/keiretsu-labs/kubernetes-manifests/tree/main/workspaces/main/skills/garage
Command: npx skills add https://github.com/keiretsu-labs/kubernetes-manifests --skill garage-operations

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the management and troubleshooting of S3-compatible object storage clusters, ensuring data availability and efficient operation.

Core Features & Use Cases

  • Cluster Health Monitoring: Quickly assess the status of Garage clusters, nodes, and operators.
  • Bucket Management: List, create, and delete S3 buckets and manage their configurations.
  • S3 Connectivity Testing: Diagnose and resolve issues related to S3 endpoint accessibility and authentication.
  • Use Case: When users report being unable to upload files to the object store, this Skill can be used to check the S3 endpoint status, verify bucket permissions, and examine operator logs for reconciliation errors.

Quick Start

Check the status of all Garage clusters and list their buckets.

Frequently Asked Questions about Garage Operations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check the status of a self-hosted Garage object storage cluster?

To check Garage cluster status, you can retrieve health data for nodes, operators, and overall storage availability using Kubernetes CRDs like GarageCluster. This monitors cluster health and identifies node or operator issues across multi-cluster environments.

How do I create and manage S3 buckets in a Garage cluster?

You can manage S3 buckets by interacting with the GarageBucket Kubernetes CRD to list, create, and delete buckets. This allows you to control bucket configurations and handle object storage operations directly within your self-hosted environment.

Why are uploads failing to my S3-compatible object store?

Upload failures to S3 object storage often stem from endpoint accessibility or authentication issues. You can diagnose these S3 connectivity problems by checking endpoint status, verifying bucket permissions, and examining operator logs for reconciliation errors.

Can I manage S3 keys and permissions for Garage object storage using Kubernetes?

Yes, you can manage S3 key authentication and permissions for Garage object storage by using the GarageKey Kubernetes CRD. This enables S3 connectivity troubleshooting and secure access control across your storage clusters.

How do I fix operator reconciliation errors in a multi-cluster Garage deployment?

To fix operator reconciliation errors in Garage deployments, you need to examine the status retrieval of your Kubernetes CRDs. This addresses issues with GarageCluster and GarageBucket resources to ensure proper operational control across multi-cluster environments.

Does Garage object storage management require Kubernetes CRDs?

Yes, managing Garage object storage through this Skill requires Kubernetes CRDs. Operational control and status retrieval depend on interacting with custom resources like GarageCluster, GarageBucket, and GarageKey for cluster health and bucket management.