README
¶
Caddy S3
This is a super basic dead simple S3 storage module for use with Caddy.
It's based on this repo, but I made it much more bare-bones and updated it because I was having issues using it with Caddy in govcloud.
Want encrypted certs? Too bad, go to the original repo I linked. Want auth via AWS Client Access ID/Secret Key ? Too bad, go to the original I linked.
This is as simple as possible so that I can get something working.
I believe the caddyfile syntax to use it should be like this
storage s3 {
bucket "your-bucket-name"
region "your-bucket-region"
}
Auth
This module relies on AWS auth that it can get from context.Background(). I plan to use this module via an IAM role I have attached to my EC2 instance that is running caddy.
Testing
I should add absolutey add unit tests, but I haven't.
Documentation
¶
Index ¶
- Variables
- type S3
- func (s3 S3) CaddyModule() caddy.ModuleInfo
- func (s3 S3) CertMagicStorage() (certmagic.Storage, error)
- func (s3 *S3) Delete(ctx context.Context, key string) error
- func (s3 *S3) Exists(ctx context.Context, key string) bool
- func (s3 *S3) List(ctx context.Context, prefix string, recursive bool) ([]string, error)
- func (s3 *S3) Load(ctx context.Context, key string) ([]byte, error)
- func (s3 *S3) Lock(ctx context.Context, key string) error
- func (s3 *S3) Provision(ctx caddy.Context) error
- func (s3 *S3) Stat(ctx context.Context, key string) (certmagic.KeyInfo, error)
- func (s3 *S3) Store(ctx context.Context, key string, value []byte) error
- func (s3 *S3) Unlock(ctx context.Context, key string) error
- func (s3 *S3) UnmarshalCaddyfile(d *caddyfile.Dispenser) error
Constants ¶
This section is empty.
Variables ¶
var ( LockExpiration = 2 * time.Minute LockPollInterval = 1 * time.Second LockTimeout = 15 * time.Second )
var ErrInvalidKey = errors.New("invalid key")
Functions ¶
This section is empty.
Source Files