AWS ECS Inspection

this node module allows you to retrieve information about an ecs instance for the current process.

During discovery this module will perform several http calls against the local ecs agent and the ec2 metadata service. AWS throttles queries to the instance metadata service on a per-instance basis and places limits on the number of simultaneous connections from an instance to the instance metadata service.

Getting Started

Installing

you can install this package via npm

npm i @openreply/ecs-inspector

Usage

const inspector = require('@openreply/ecs-inspector');
// using the promise interface
inspector().then( result => console.log(result) ).catch( error => console.error(error.message) );
// using callbacks
inspector({callback: (err, result) => {
  if (err) {
    return console.error(err.message);
  }
  console.log(result);
}});

Example result

{
  cluster: 'default',
  arn: 'arn:aws:ecs:eu-central-1:123456789012:task/9c621769-1a09-42c7-8d5d-2ba3319682c7',
  dockerId: '2418684f95999553475079f1c6845f5b6cc99a057cbe680a82ad3396db799542',
  containerName: 'service-b',
  ports: [{
    protocol: 'tcp',
    container: 3000,
    host: 36092
  }],
  publicHostname: 'some-host.example.com',
  publicIpv4: '134.102.200.14',
  localHostname: 'private-hostname.internal',
  localIpv4: '10.0.1.10'
}

ECSTaskInformationPortInfo : Object

Kind: global typedef
Properties

| Name | Type | Description | | --- | --- | --- | | protocol | string | protocol used e.g. tcp | | container | number | port on the container side | | host | number | port on the host side |

ECSTaskInformation : Object

Kind: global typedef
Properties

| Name | Type | Description | | --- | --- | --- | | arn | string | aws arn uniquely identifying the task | | cluster | string | name of the cluster | | dockerId | string | docker id | | containerName | string | name of the container | | publicHostname | string | public dns domain name of the ec2 instance (if available) | | publicIpv4 | string | public ipv4 address of the ec2 instance (if available) | | localHostname | string | private dns domain name of the ec2 instance (if available) | | localIpv4 | string | private ipv4 address of the ec2 instance (if available) | | ports | Array. | docker to host port mapping |

See the API documentation for more details.

Running the tests

You can run the test suite via

npm test

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

• Florian Schaper - Initial work - openreply-de

See also the list of authors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

References

• ecs agent inspection documentation
• ecs metadata file documentation
• ec2 metadata api