Version 1

This documentation is for Deis v1 PaaS. For Workflow (v2) documentation visit https://deis.com/docs/workflow/.

Customizing store-gateway

The following settings are tunable for the Store component’s gateway service.

Dependencies

Requires: store-daemon, store-monitor

Required by: database, registry

Considerations: none

Settings set by store-gateway

The following etcd keys are set by the store-gateway component, typically in its /bin/boot script.

setting description
/deis/store/gatewayKeyring keyring for the gateway user to access the Ceph cluster (generated by Ceph)
/deis/store/gateway/accessKey S3 API access used to access store-gateway (generated by Ceph)
/deis/store/gateway/host IP address of the host running store-gateway
/deis/store/gateway/port port used by the store-gateway service (default: 8888)
/deis/store/gateway/secretKey S3 API secret key used to access store-gateway (generated by Ceph)

Settings used by store-gateway

The following etcd keys are used by the store-gateway component.

setting description
/deis/store/adminKeyring keyring for an admin user to access the Ceph cluster (set by store-monitor)
/deis/store/fsid Ceph filesystem ID (set by store-monitor)
/deis/store/hosts/* deis-monitor hosts (set by store-monitor)
/deis/store/maxPGsPerOSDWarning threshold for warning on number of placement groups per OSD (set by store-monitor)
/deis/store/monKeyring keyring for the monitor to access the Ceph cluster (set by store-monitor)
/deis/store/monSetupComplete set when the Ceph cluster setup is complete (set by store-monitor)
/deis/store/monSetupLock host of store-monitor that completed setup (set by store-monitor)
/deis/store/minSize minimum number of store-daemons necessary for the cluster to accept writes (set by store-monitor)
/deis/store/pgNum number of Ceph placement groups for the storage pools (set by store-monitor)
/deis/store/size number of replicas for data stored in Ceph (set by store-monitor)

Using a custom store-gateway image

You can use a custom Docker image for the store-gateway component instead of the image supplied with Deis:

$ deisctl config store-gateway set image=myaccount/myimage:latest

This will pull the image from the public Docker registry. You can also pull from a private registry:

$ deisctl config store-gateway set image=registry.mydomain.org:5000/myaccount/myimage:latest

Be sure that your custom image functions in the same way as the stock store-gateway image shipped with Deis. Specifically, ensure that it sets and reads appropriate etcd keys.