README
¶
azcertcache
Azure Blob Storage cache for acme/autocert written in Go.
Example
containerName := "autocertcache"
cache, err := azcertcache.New("<account name>", "<account key>", containerName)
if err != nil {
// Handle error
}
m := autocert.Manager{
Prompt: autocert.AcceptTOS,
Cache: cache,
}
s := &http.Server{
Addr: ":https",
TLSConfig: &tls.Config{GetCertificate: m.GetCertificate},
}
s.ListenAndServeTLS("", "")
Performance
This is just a reminder that autocert has an internal in-memory cache that is used before quering this long-term cache. So you don't need to worry about your Azure Blob Storage instance being hit many times just to get the same certificate. It should only do once per process+key.
Thanks
Inspired by https://github.com/danilobuerger/autocert-s3-cache
License
MIT
Documentation
¶
Overview ¶
Package azcertcache implements an autocert.Cache to store certificate data within an Azure Blob Storage container
Index ¶
- Variables
- type Cache
- func (c *Cache) CreateContainer(ctx context.Context) error
- func (c *Cache) Delete(ctx context.Context, key string) error
- func (c *Cache) DeleteContainer(ctx context.Context) error
- func (c *Cache) Get(ctx context.Context, key string) ([]byte, error)
- func (c *Cache) Put(ctx context.Context, key string, data []byte) error
Constants ¶
This section is empty.
Variables ¶
var ErrEmptyContainerName = errors.New("containerName must not be empty")
ErrEmptyContainerName is returned when given container name is empty
Functions ¶
This section is empty.
Types ¶
type Cache ¶
type Cache struct {
// contains filtered or unexported fields
}
Cache provides an Azure Blob Storage backend to the autocert cache.
func New ¶
New creates an cache instance that can be used with autocert.Cache. It returns any errors that could happen while connecting to Azure Blob Storage.
func NewWithEndpoint ¶
NewWithEndpoint creates an cache instance that can be used with autocert.Cache. Endpoint can be used to target a different environment that is not Azure It returns any errors that could happen while connecting to Azure Blob Storage.
func (*Cache) CreateContainer ¶
CreateContainer based on current configured container
func (*Cache) Delete ¶
Delete removes a certificate data from the cache under the specified key. If there's no such key in the cache, Delete returns nil.
func (*Cache) DeleteContainer ¶
DeleteContainer based on current configured container
Source Files