{"_id":"@mapbox/ecs-info","_rev":"251-e63197a7b635964cbd76b1800afdc4a8","name":"@mapbox/ecs-info","description":"Library for querying the state of an AWS::ECS::Cluster","dist-tags":{"latest":"0.0.7"},"versions":{"0.0.7":{"name":"@mapbox/ecs-info","version":"0.0.7","description":"Library for querying the state of an AWS::ECS::Cluster","main":"index.js","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"bin":{"ecs-info":"bin/ecs-info.js"},"repository":{"type":"git","url":"git+https://github.com/mapbox/ecs-info.git"},"author":{"name":"Mapbox"},"license":"ISC","bugs":{"url":"https://github.com/mapbox/ecs-info/issues"},"homepage":"https://github.com/mapbox/ecs-info#readme","devDependencies":{"@mapbox/mock-aws-sdk-js":"0.0.3","eslint":"^3.4.0","nyc":"^8.1.0","opener":"^1.4.1","tape":"^4.6.0"},"dependencies":{"agentkeepalive":"^2.2.0","aws-sdk":"^2.5.5","cloudfriend":"^1.1.0","d3-queue":"^3.0.3","easy-table":"^1.0.0","inquirer":"^1.2.2","meow":"^3.7.0"},"gitHead":"284f70382f156273681eb9423394cd1baed7ca21","_id":"@mapbox/ecs-info@0.0.7","_shasum":"4505fddfd22202b6e2fe581a0c77db28077f347c","_from":".","_npmVersion":"2.15.6","_nodeVersion":"4.1.2","_npmUser":{"name":"arunasank","email":"aruna@mapbox.com"},"dist":{"shasum":"4505fddfd22202b6e2fe581a0c77db28077f347c","tarball":"https://registry.npmjs.org/@mapbox/ecs-info/-/ecs-info-0.0.7.tgz","integrity":"sha512-GCazrt0WBoUrrH4D/v6UYZG9w/GjQjPHPgqNKRcHR7UgHqR16/o4yEBBPJoiyzqlyOKbfPImaQb8vuxdDuov8Q==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIFoCVqVoPq+Ymc2tw3cvX+Fa/suERDsF/ZufGRUFqtMlAiAsevk434lXJZNXqVAfoYTqwWOizVxd+FJv6b9z4HkZkA=="}]},"maintainers":[{"name":"arunasank","email":"aruna@mapbox.com"}],"_npmOperationalInternal":{"host":"packages-18-east.internal.npmjs.com","tmp":"tmp/ecs-info-0.0.7.tgz_1491520191747_0.909847928211093"},"directories":{}}},"readme":"# ecs-info\n\nLibrary for querying the state of an AWS::ECS::Cluster\n\n#### work in progress\n\n```js\nvar ecs = require('ecs-info');\necs.Cluster.describe('my-cluster', 'us-east-1')\n  .then(clusterData => { ... });\n```\n\n## Cluster description\n\nThe object that comes back has circular references that you can use to trace the\nrelationships between EC2 instances, ECS services, and ECS tasks that are part\nof the cluster. Basically:\n\n```\nCluster {\n  tasks: [ ...Task {} ],\n  instances: [ ...Instance {} ],\n  services: [ ...Service {} ]\n}\n```\n\nA `Cluster` is the [response from an ecs.describeClusters request](http://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/ECS.html#describeClusters-property) with additional properties:\n- **tasks** an array of tasks running or stopped on the cluster\n- **services** an array of services running on the cluster\n- **instances** an array of instances in the cluster\n\nA `Task` is the [response from an ecs.describeTasks request](http://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/ECS.html#describeTasks-property) with additional properties:\n- **instance** the host instance\n- **service** the service this task is a part of (or null)\n- **taskDefinition** the [response from an ecs.describeTaskDefinition request](http://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/ECS.html#describeTaskDefinition-property)\n\nA `Service` is the [response from an ecs.describeServices request](http://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/ECS.html#describeServices-property) with additional properties:\n- **tasks** an array of tasks that are part of the service\n- **loadBalancers** the array of objects describing a service's load balancers (part of the [ecs.describeServices response](http://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/ECS.html#describeServices-property)) is augmented to include:\n  - **targetHealthDescriptions** [response from elbv2.describeTargetHealth request](http://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/ELBv2.html#describeTargetHealth-property) for the case of an application load balancer\n  - **instanceStates** [response from an elb.describeInstanceHealth request](http://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/ELB.html#describeInstanceHealth-property) for the case of a classic load balancer\n\nAn `Instance` is the [response from an ecs.describeContainerInstances request](http://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/ECS.html#describeContainerInstances-property) with additional properties:\n- **ec2Info** the [response from an ec2.describeInstances request](http://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/EC2.html#describeInstances-property)\n- **tasks** an array of tasks running on the instance\n\nFurthermore, each of these classes have a set of prototype methods that they implement. These can be useful for formatting or resolving specific information about a cluster, task, service, or instance.\n\n## Additional treats\n\nReturn an array of IAM policy statements providing permission to run the API requests involved in this library:\n\n```js\necs.iamPermissions('my-cluster-name');\n```\n","maintainers":[{"email":"yannick.meeus+npm+production+ci@mapbox.com","name":"mbx-npm-ci-production"},{"email":"yannick.meeus+npm+staging+ci@mapbox.com","name":"mbx-npm-ci-staging"},{"email":"yannick.meeus+npm+prod+advanced+actions@mapbox.com","name":"mbx-npm-advanced-actions-production"},{"email":"yannick.meeus+npm+staging+advanced+actions@mapbox.com","name":"mbx-npm-advanced-actions-staging"},{"email":"yannick.meeus+npm+prod+09@mapbox.com","name":"mbx-npm-09-production"},{"email":"yannick.meeus+npm+prod+08@mapbox.com","name":"mbx-npm-08-production"},{"email":"yannick.meeus+npm+prod+07@mapbox.com","name":"mbx-npm-07-production"},{"email":"yannick.meeus+npm+prod+06@mapbox.com","name":"mbx-npm-06-production"},{"email":"yannick.meeus+npm+prod+05@mapbox.com","name":"mbx-npm-05-production"},{"email":"yannick.meeus+npm+prod+04@mapbox.com","name":"mbx-npm-04-production"},{"email":"yannick.meeus+npm+prod+03@mapbox.com","name":"mbx-npm-03-production"},{"email":"yannick.meeus+npm+prod+02@mapbox.com","name":"mbx-npm-02-production"},{"email":"yannick.meeus+npm+prod+01@mapbox.com","name":"mbx-npm-01-production"},{"email":"yannick.meeus@mapbox.com","name":"mbx-npm-02-staging"},{"email":"accounts+npmjs-01@mapbox.com","name":"mapbox-npm-01"},{"email":"accounts+npmjs-02@mapbox.com","name":"mapbox-npm-02"},{"email":"accounts+npmjs-07@mapbox.com","name":"mapbox-npm-07"},{"email":"accounts+npmjs-03@mapbox.com","name":"mapbox-npm-03"},{"email":"accounts+npmjs-04@mapbox.com","name":"mapbox-npm-04"},{"email":"accounts+npmjs-09@mapbox.com","name":"mapbox-npm-09"},{"email":"accounts+npmjs-05@mapbox.com","name":"mapbox-npm-05"},{"email":"accounts+npmjs-06@mapbox.com","name":"mapbox-npm-06"},{"email":"accounts+npmjs-08@mapbox.com","name":"mapbox-npm-08"},{"email":"accounts+npmjs-advanced-actions@mapbox.com","name":"mapbox-npm-advanced-actions"},{"email":"accounts+npmjs-npm-ci@mapbox.com","name":"mapbox-npm-ci"},{"email":"accounts+npmjs@mapbox.com","name":"mapbox-npm"},{"email":"accounts@mapbox.com","name":"mapbox-admin"},{"email":"accounts+npm-mapbox-machine-user@mapbox.com","name":"mapbox-machine-user"}],"time":{"modified":"2023-01-12T12:42:10.618Z","created":"2017-04-06T23:09:52.394Z","0.0.7":"2017-04-06T23:09:52.394Z"},"homepage":"https://github.com/mapbox/ecs-info#readme","repository":{"type":"git","url":"git+https://github.com/mapbox/ecs-info.git"},"author":{"name":"Mapbox"},"bugs":{"url":"https://github.com/mapbox/ecs-info/issues"},"license":"ISC","readmeFilename":"readme.md"}