Grunt plugin for AWS's Elastic Container Repository service.

This plugin requires Grunt ~0.4.5

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-aws-ecr --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-aws-ecr');

In your project's Gruntfile, add a section named aws_ecr to the data object passed into grunt.initConfig().

grunt.initConfig({
  aws_ecr: {
    options: {
      // Task-specific options go here.
    },
    your_target: {
      // Target-specific file lists and/or options go here.
    },
  },
});

Options configure the ECR service provided by aws-sdk. Valid options can be found in the AWS JavaScript SDK documentation. Not all options can be used with this plugin alone. Specifically sessionToken, credentials and credentialsProvider are unavailable with this plugin alone as they must be instances of classes provided by the AWS SDK not provided by this plugin.

A minimum working configuration for options would be:

{
  accessKeyId:     'STRING_VALUE',
  secretAccessKey: 'STRING_VALUE',
  region:          'us-west-2'
}

Whether your configuration has a single task or multiple targets, each must inlude a command property. Commands are kebab case string in the style of the AWS cli (e.g. delete-repository, create-repository, etc.). CLI commands are all represented by methods in the SDK ECR service, except for get-login.

Each command corresponds to a method in the SDK ECR service. Aside from command, noted above and callback, noted below, each property in a task's configuration is passed as a parameter to the SDK method. Valid parameters can be found in the documentation for the corresponding method. Methods have the same name as the corresponding command, but are in camel case.

Each command will receive the callback you provide in its configuration. The first and only argument will be the response from the AWS ECR service. This differs from SDK documentation.

{
  command:    'get-authorization-token',
  callback:    data => console.log(JSON.stringify(data, null, 2)),
  registryIds: [ 'STRING_VALUE' ]
}

registryIds in this example is a valid AWS account number in which repository(ies) exist.

(Nothing yet)