s3gw is an S3-compatible service focused on deployments in a Kubernetes environment backed by any PVC, including Longhorn. Since its inception, the primary focus has been on cloud native deployments. However, the s3gw can be deployed in a myriad of scenarios, provided some form of storage is attached.
Helm Chart
An easy way to deploy the S3 Gateway on your Kubernetes cluster is via a Helm chart:helm repo add s3gw https://aquarist-labs.github.io/s3gw-charts/
helm install s3gw s3gw/s3gw --namespace s3gw-system --create-namespace \
--set publicDomain=YOUR_DOMAIN_NAME \
--set ui.publicDomain=YOUR_DOMAIN_NAMEHelm is the preferred deployment method, and will automatically use your cluster's default storage class for the backing store. If you have Longhorn installed already, s3gw will thus use a Longhorn PV. The above assumes cert-manager and traefik are available, but these and other settings can be overridden via values.yaml.
Check out the documentation for details and configuration options.
Podman
podman run --replace --name=s3gw -it -p 7480:7480 quay.io/s3gw/s3gw:latestPodman deployments will use ephemeral storage inside the container by default,
which should only be used for testing purposes. To use a directory on the
host system for storage, pass -v/host-path:/data.
Docker
docker pull quay.io/s3gw/s3gw:latestIn order to run the Docker container:
docker run -p 7480:7480 quay.io/s3gw/s3gw:latestDocker deployments will use ephemeral storage inside the container by default,
which should only be used for testing purposes. To use a directory on the
host system for storage, pass -v/host-path:/data.
You can access our documentation here.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use licensed files except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
or the LICENSE file in this repository.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.