@broadcom/endevor-bridge-for-git-for-zowe-cli/README.md

Endevor Bridge for Git plug-in for Zowe CLI

# Endevor Bridge for Git for Zowe CLI

The Endevor Bridge for Git Plug-in for Zowe CLI allows you to work with and manage Git-Endevor mappings of your Bridge for Git server. Also, as a developer, you can build the changed files from the local working directory of your mapping in an Endevor work area. 

## Use Cases

As an application developer, you can use the plug-in to perform the following tasks:
- Build the changes of your local working directory of a Git-Endevor mapping in Endevor. (`@zowe-v1-lts`, `@zowe-v2-lts`, `@latest`)
- Manage Git-Endevor mappings from the CLI. (`@zowe-v2-lts`, `@latest`)

    Enables you to create the same kind of Git-Endevor mappings that are supported in the application. You can also manage the branches of existing mappings.

- Manage mainframe credentials for Git-Endevor mappings. (`@zowe-v2-lts`, `@latest`)

For more information about the plug-in, see Endevor Bridge for Git Plug-in for Zowe CLI in the product documentations of [Endevor Integrations for Enterprise DevOps](https://techdocs.broadcom.com/us/en/ca-mainframe-software/devops/ca-endevor-integrations-for-enterprise-devops/1-0/ca-endevor-bridge-for-git/ca-endevor-bridge-for-git-plug-in-for-zowe-cli.html) and [Brightside](https://techdocs.broadcom.com/us/en/ca-mainframe-software/devops/ca-brightside/3-0/zowe-cli/available-cli-plug-ins/ca-endevor-bridge-for-git-plug-in-for-zowe-cli.html).

## Software Requirements

Before you use the plug-in, ensure that you meet the following prerequisites:

- Zowe CLI v6.17.3 or higher
- Endevor Plug-in for Zowe CLI v6.4.0 or higher

For use with Zowe V2, ensure that you meet the following prerequisites
- Zowe CLI v7.0.0 or higher
- Endevor Plug-in for Zowe CLI 7.0.1 or higher

## Install the Endevor Bridge for Git Plug-in for Zowe CLI

The Endevor Bridge for Git Plug-in for Zowe CLI is associated with the following tags:

`@latest`

`@zowe-v2-lts`

`@zowe-v1-lts`

The version with the `@latest` tag is actively updated with new features and functionality.

The `@zowe-v2-lts` tag represents the V2 stable version of the plug-in which conforms to the Zowe V2 Conformance criteria, including the team configuration support.

The `@zowe-v1-lts` tag represents the V1 stable version of the plug-in which might not include all of the newest functionality.

To install the active version of the plug-in, issue the following command:
```
zowe plugins install @broadcom/endevor-bridge-for-git-for-zowe-cli@latest
```
To install the V2 stable version of the plug-in, issue the following command:
```
zowe plugins install @broadcom/endevor-bridge-for-git-for-zowe-cli@zowe-v2-lts
```
To install the stable version of the plug-in, issue the following command:
```
zowe plugins install @broadcom/endevor-bridge-for-git-for-zowe-cli@zowe-v1-lts
```