aws

Overview ¶

Package aws implements the Celerity resource interfaces against AWS.

It is selected by importing it, which is how an application picks a platform without naming one anywhere else:

import _ "github.com/newstack-cloud/celerity-go-sdk/resources/aws"

An init registers the provider, and the generated platform file writes that import for an AWS deploy target, so handler code deals only in the provider-agnostic interfaces from the resources package and an application doesn't need to name a platform at all.

What a handle resolves to ¶

A handle is taken by the name the blueprint gave a resource, and what that resource is actually called is decided when it is created. The pair is held by the deployment: the links file says which config key holds a resource, and the resources namespace holds the identifier. This package reads both through the resources.Ref it is given and never learns how either is written.

Nothing is resolved while handles are being taken. A client built here holds its Ref and resolves on the first call a handler makes, so registration costs no requests and an application declaring a resource it never reaches pays nothing for it.

Separate module ¶

aws-sdk-go-v2 is a large dependency, and on Lambda a cold start cost rather than only a disk one, so an application that never touches AWS does not compile it in.