bitbucket-env-manager/Readme.md

Deploys Bitbucket Environment

# Bitbucket Deploy Pipeline Environments
> A command line tool to manage Bitbucket pipeline deployment variables for different environments across multiple repositories

### Installation
```
$ npm i -g bitbucket-env-manager
```

### Usage
```
$ bitbucket-env-manager <command_name>
```

### Available commands
```
init
generate
------
deploy
list
delete
``` 
---
## Initialize Credentials
- Setup Oauth Consumer keys in bitbucket with proper env variable edit access. 
- It should create `~/.bitbucket_env_manager/<workspace>.env` file
- During the auth API calls, this should create access tokens in `~/.bitbucket_env_manager/<workspace>_tokens.json` file
```
bitbucket-env-manager init
```
- Set `OAUTH_CLIENT`, `OAUTH_SECRET` and `WORKSPACE` 


## Generate
```
$ bitbucket-env-manager generate
```
- Creates a new project manager folder with example for bitbucket environments
- In `project_envs/example/info.json` set the workspace and repository_slug names from bitbucket.
  - `workspace`
  - `repo` 


## Deploy
```
$ bitbucket-env-manager deploy
```
- Select multiple `.env` files to be deployed to bitbucket from `project_envs` folder.
- As indicated in example folder, the folder should 
  - contain .env file with name pattern `.env.{0|1|2}.{env_name}` .
    - `{0|1|2}` is for the rank of the environment to be created. 
      - 0 -> Test, 1 -> Staging, 2 -> Production
    - `{env_name}` is the environment name to be created.
  - contain `info.json` file, with
    - `workspace` : workspace name
    - `repo` : repository_slug name
    - `secured` : [], an Array with keys from the env file that need to marked as secured in bitbucket.
    - `envs_config` : `{ [env_name] : {admin_only:boolean} }`, Config object for each {env_name}. admin_only boolean flag allows to specify if the environment needs to be restricted to be deployed by admins only.

 
  
  ### Example: 
  
  `.env.0.Development` filename deployment will delete any existing `Development` environment and variables from the bitbucket repository, and creates a new `Development` environment under `Test` Category.


## List
```
$ bitbucket-env-manager list
```
- Allows to list variables from existing environment from the repository 
- Select the `info.json` file for the desired repository
- Select the `env_name` from the list to to view the variables from the environment in bitbucket.


## Delete
```
bitbucket-env-manager delete
```
- Allows to delete a existing environment from the repository 
- Select the `info.json` file for the desired repository
- Select the `env_name` from the list to remove the environment from bitbucket.