# gulp-awsebtdeploy

> A module to make easy AWS Elasticbeanstalk deployment

Latest version **3.0.0** (published 2025-10-08) · MIT license · 0 weekly downloads

## Install

```sh
npm install gulp-awsebtdeploy
pnpm add gulp-awsebtdeploy
yarn add gulp-awsebtdeploy
bun add gulp-awsebtdeploy
```

## Health

**Score 45/100 (D)** — status: stable.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2025-10-08 |
| First published | 2018-05-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 6 |
| Unpacked size | 15.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Seungjae Lee |
| Maintainers | swaven |
| Keywords | gulp, gulp-plugin, gulp-module, plugin, amazon, aws, eb, elastic, beanstalk, elasticbeanstalk, deploy, upload |

## Links

- npm: https://www.npmjs.com/package/gulp-awsebtdeploy
- Repository: https://github.com/Swaven/gulp-awsebtdeploy
- Homepage: https://github.com/Swaven/gulp-awsebtdeploy#readme
- Issues: https://github.com/Swaven/gulp-awsebtdeploy/issues
- npm.io page: https://npm.io/package/gulp-awsebtdeploy

## Dependencies (6)

- [chai](https://npm.io/package/chai.md) 4.5
- [mocha](https://npm.io/package/mocha.md) 11.7.2
- [fancy-log](https://npm.io/package/fancy-log.md) ^2.0.0
- [ansi-colors](https://npm.io/package/ansi-colors.md) ^4.1.3
- [@aws-sdk/client-s3](https://npm.io/package/@aws-sdk/client-s3.md) ^3.882.0
- [@aws-sdk/client-elastic-beanstalk](https://npm.io/package/@aws-sdk/client-elastic-beanstalk.md) ^3.882.0

## Alternatives

- [@opentelemetry/exporter-zipkin](https://npm.io/package/@opentelemetry/exporter-zipkin.md) — 14.8M weekly downloads
- [pusher-js](https://npm.io/package/pusher-js.md) — 2.0M weekly downloads
- [browserify](https://npm.io/package/browserify.md) — 1.7M weekly downloads
- [sqs-consumer](https://npm.io/package/sqs-consumer.md) — 1.7M weekly downloads
- [@sanity/eventsource](https://npm.io/package/@sanity/eventsource.md) — 930.8K weekly downloads

## Recent versions

- 3.0.0 (latest) — 2025-10-08
- 2.0.0 — 2018-05-24

## README

gulp-awsebtdeploy
=====

> A gulp plugin for deployment your application to AWS Elastic Beanstalk

This plugin helps you to integrate your deployment task on the Amazon AWS Elasticbeanstalk service into gulp. Your deployment job will be more mainatainable and efficient, so that you can increase productivity.

Forked from https://github.com/a0ly/gulp-beanstalk-deploy.

## Getting Started

You can install plugin by this command:
```shell
npm install gulp-awsebtdeploy
```

## Overview
```javascript
const eb = require('gulp-awsebtdeploy')

// returns a promise
return eb({
  // options here
})
```

The task returns a promise that resolves when the target environment's status becomes ***Ready***.

### Options

A * indicates a mandatory option.

##### accessKeyId

* Type: `string`
* Default: `~/.aws/credentials`

The aws access key id. If nothing passwed, it will use your local aws profile credential.

##### secretAccessKey

* Type: `string`
* Default: `~/.aws/credentials`

The aws access secret access key. If nothing passwed, it will use your local aws profile credential.

##### region *
* Type: `string`

Your application region. It must be provided.

##### applicationName *
* Type: `string`

Your application name. It must be provided.

##### environmentName *
* Type: `string`

Your application environment name. It must be provided.

##### versionLabel
* Type: `string`
* Default: sourceBundle file name without the extension

##### description
* Type: `string`

Your deployment description.

##### settings
* Type: `Array`

Your environment setting parameters.

##### waitForDeploy
* Type: `boolean`
* Default: true

##### checkIntervalSec
* Type: `number`
* Default: 2sec

Interval time to check deploying status. (sec)

##### s3Bucket
* Type: `object`
* Default:
```javascript
{
    bucket: // applicationName
    key: // sourceBundle basename
}
```

##### sourceBundle *
* Type: `string`

archive file path to upload. It must exists in your local file system, which means the archive file must be prepared before deployment task.


##### proxy
* Type: `string`
* Default: none

Optional proxy url to use for requests.

## Usage Example
``` javascript
const eb = require('gulp-awsebtdeploy');

eb({
  accessKeyId: 'Your AWS accessKeyId', // optional
  secretAccessKey: 'Your AWS secretAccessKey', // optional
  region: 'us-west-1', // required
  applicationName:'gulp-beanstalk-deploy',
  environmentName: 'gulp-beanstalk-deploy-env',
  versionLabel: '1.0.0',
  sourceBundle: './archive.zip',
  description: 'description here'
});

```

## License
MIT

---
_Source: https://npm.io/package/gulp-awsebtdeploy · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._