serverless-resource-names

Serverless Resource Names Plugin

This plugin generate resources names from your resource's Logical ID in Resources:

Setup

Install via npm or yarn in the root of your Serverless project:

npm install serverless-resource-names --save-dev

or

yarn add serverless-resource-names --dev

Apply plugin

plugins:
  - serverless-resource-names

Why?

Suppose you have one or many resources in your serverless.yml like so:

Resources:
  SomeQueueOne:
    Type: AWS::SQS::Queue
    Properties:
      QueueName: ${self:service.name}-some-queue-one-${self:provider.stage}
      ...

  SomeQueueTwo:
    Type: AWS::SQS::Queue
    Properties:
      QueueName: ${self:service.name}-some-queue-two-${self:provider.stage}
      ...

  UploadBucket:
    Type: AWS::S3::Bucket
    Properties:
      BucketName: ${self:service.name}-upload-bucket-${self:provider.stage}
      ...

Notice how you have to constantly specify names for these services?

Futhermore you're likely to use them in your environment variables as well

provider:
  environment:
    SOME_QUEUE_ONE: ${self:service.name}-some-queue-one-${self:provider.stage}
    SOME_QUEUE_TWO: ${self:service.name}-some-queue-two-${self:provider.stage}
    UPLOAD_BUCKET: ${self:service.name}-upload-bucket-${self:provider.stage}

This becomes very troublesome to manage when your resources grow and you'll constantly need to add these things

What does it do?

To solve this problem this plugin generates the equivalent resources names by looking at the reference's Logical ID in your serverless.yml

So now you can omit the BucketName (or other name properties for other resources)

So the following resource...

UploadBucket:
  Type: AWS::S3::Bucket
  Properties: ...

...will generate the following based on the reference Logical ID: UploadBucket:

UploadBucket:
  Type: AWS::S3::Bucket
  Properties:
    BucketName: service-name-upload-bucket-dev

functions:
  hello:
    environment:
      UPLOAD_BUCKET: service-name-upload-bucket-dev
      ...
    ...

NOTE: Resources with already existing name properties will not be modifiede but will be injected as environment variables with same naming convetions based of the resources Logical ID

Settings

You can change the prefix for your resources using

custom:
  resourceNames:
    prefix: "awesome-prefix"

Default will prefix using your service name in serverless.yml

Referencing generated names

You can also reference the generated in other resources using the ${name:LogicalId} variable as follows:

functions:
  hello:
    handler: handler.hello
    events:
      - s3:
          bucket: ${name:MyBucket}
          existing: true

resources:
  Resources:
    MyBucket:
      Type: AWS::S3::Bucket

SNS Topics

This plugin will simplify referencing SNS topics. To reference a topic trigger for your lambda simply use: ${topic:TopicResourceName} i.e:

functions:
  hello:
    handler: handler.hello
    events:
      - sns: ${topic:MyTopic}

resources:
  Resources:
    MyTopic:
      Type: AWS::SNS::Topic

The plugin will also inject SNS Topic- & SQS Queue ARNs as an environment variables using the same naming conventions suffixed by _ARN or _URL. For the example above that would be: MY_TOPIC_ARN.

For SQS queues the plugin will suffix and return the queue url value rather than the queue name.

Commands

Run serverless env to print all environment variables (generated and custom)

Note: all Intristic Functions are printed as escaped json

Example:

ENVIRONMENT_VALUE_1=1
ENVIRONMENT_VALUE_2=2
SOME_TOPIC_ARN="{\"Fn::Join\":[\":\",[\"arn\",\"aws\",\"sns\",{\"Ref\":\"AWS::Region\"},{\"Ref\":\"AWS::AccountId\"},\"my-prefix-some-topic-dev\"]]}"
SOME_TOPIC="my-prefix-some-topic-dev"