# Serverless Stack Termination Protection Plugin [](https://www.npmjs.com/package/serverless-stack-termination-protection) [](https://snyk.io/test/github/miguel-a-calles-mba/serverless-stack-termination-protection) ## Table of Contents 1. [Description](#description) 2. [Requirements](#requirements) 3. [Installation](#installation) 4. [Using the Plugin](#using-the-plugin) 5. [Notes](#notes) 6. [License](#license) ## Description Following deployment, the Serverless Framework does not have the option to enable termination protection for the CloudFormation stack. This plugin will enable the termination protection. It can also disable it by using a command line option. This plugin is designed for the Serverless Framework 1.x and above. ## Requirements - Serverless Framework 3.x or greater. - Node 8.x or greater. - NPM 6.x or greater. Use `serverless-stack-termination-protection@1` if you need support for Serverless Framework 2.x or below. ## Installation ### Installing the Serverless Framework Visit the [Getting Started with the Serverless Framework](https://serverless.com/framework/docs/getting-started) to get started with the Serverless Framework. Install with **npm**: ```sh npm install -g serverless ``` ### Installing the Plugin Install with **npm**: ```sh npm install --save-dev serverless-stack-termination-protection ``` And then add the plugin to your `serverless.yml` file: ```yaml plugins: - serverless-stack-termination-protection ``` See the [example(s)](./examples). ## Using the Plugin ### Automatically Enable Termination Protection After Deployment This plugin enables termination protection automatically after the deployment. Simply run the **deploy**: ```sh sls deploy ``` ### Automatically Disable Termination Protection After Deployment This plugin can disable termination protection automatically after the deployment. Simply run the **deploy** with the **--param** option: ```sh sls deploy --param disable-termination-protection ``` If you are using multiple params, make sure to separate them: ```sh sls deploy --param disable-termination-protection --param some-other-param ``` ### Apply Protection to Specified Stages You may apply protection for specific stages by listing the stages under a **serverlessTerminationProtection** custom property in the serverless yaml file. ```yaml custom: serverlessTerminationProtection: stages: - prod ``` ### Notes Future version will: * Delete the stack forceably using `sls remove --force`. Please request features or report problems using the [issues](https://github.com/miguel-a-calles-mba/serverless-stack-termination-protection/issues) page. ## License See the included [LICENSE](LICENSE) for rights and limitations under the terms of the MIT license.