gcscache

README

GCS Cache

GCS Cache implements the autocert.Cache interface using Google Cloud Storage.

Example Usage

package main

import (
    "crypto/tls"
    "log"
    "net/http"

    "github.com/kelseyhightower/gcscache"
    "golang.org/x/crypto/acme/autocert"
)

func main() {
    cache, err := gcscache.New("bucket")
    if err != nil {
        log.Fatal(err)
    }

    m := autocert.Manager{
        Cache:      cache,
        Prompt:     autocert.AcceptTOS,
        HostPolicy: autocert.HostWhitelist("example.org"),
    }

    mux := http.NewServeMux()
    mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        w.Write([]byte("Autocert with Google Cloud Storage Cache"))
    })

    s := &http.Server{
        Addr:      "0.0.0.0:443",
        Handler:   mux,
        TLSConfig: &tls.Config{GetCertificate: m.GetCertificate},
    }

    s.ListenAndServeTLS("", "")
}

Documentation

Overview

Package gcscache provides storage, backed by Google Cloud Storage, for certificates managed by the golang.org/x/crypto/acme/autocert package.

This package is a work in progress and makes no API stability promises.

Index

• type Cache
  • func New(bucket string, option ...option.ClientOption) (*Cache, error)
  • func (c *Cache) Delete(ctx context.Context, name string) error
  • func (c *Cache) Get(ctx context.Context, name string) ([]byte, error)
  • func (c *Cache) Put(ctx context.Context, name string, data []byte) error

Types

type Cache

type Cache struct {
	// contains filtered or unexported fields
}

Cache implements the autocert.Cache interface using Google Cloud Storage.

func New

func New(bucket string, option ...option.ClientOption) (*Cache, error)

New creates and initializes a new Cache backed by the given Google Cloud Storage bucket.

func (*Cache) Delete

func (c *Cache) Delete(ctx context.Context, name string) error

Delete removes the specified object name.

func (*Cache) Get

func (c *Cache) Get(ctx context.Context, name string) ([]byte, error)

Get reads a certificate data from the specified object name.

func (*Cache) Put

func (c *Cache) Put(ctx context.Context, name string, data []byte) error

Put writes the certificate data to the specified object name.