zowe › endevor-bridge-for-git › create › branch🖨️

Add a branch to an existing mapping

Usage

zowe endevor-bridge-for-git create branch [context] [mapping] <branch> [options]

Positional Arguments

• context (string)

  • Git-Endevor mapping context (ID of the organization, project, team, or the Git repository owner).

• mapping (string)

  • Git-Endevor mapping name (Git repository ID).

• branch (string)

  • Name of the branch to add or remove.

Options

• --endevor-system | --endevorsys | --system (string)

  • Endevor system where your project resides.

• --endevor-subsystem | --endevorsub | --sub | --subsystem (string)

  • Alias of Endevor subsystem.

• --system-alias (string)

  • Alias of Endevor system.

• --subsystem-alias (string)

  • Alias of Endevor subsystem.

• --endevor-environment | --endevorenv | --env | --environment (string)

  • Endevor environment where your project resides.

• --read-only (boolean)

  • If specified, it is necessary to use the option --endevor-stage-number. The synchronized elements will be read-only.

• --endevor-stage-number | --endevorsn (string)

  • Endevor stage where your project resides (only for read-only mappings).

• --mapping-mode (string)

  • Mapping mode of the mapping ('FULL', 'WORK_ENV_ONLY' or 'MIRROR').

    Allowed values: FULL, WORK_ENV_ONLY, MIRROR

• --like (string)

  • Add branch using parameters from another branch in the same repository

• --repository-check (string)

  • If set to allowNonEmpty, user can proceed with initialization of the branch even if the branch exists.

    Default value: REQUIRE_EMPTY
    Allowed values: REQUIRE_EMPTY, ALLOW_NON_EMPTY

Endevor options (alternatively use an 'endevor' profile)

• --endevor-protocol | --endevorprot (string)

  • Endevor SCM Rest API protocol.

    Default: http

    Allowed values: http, https

• --endevor-host | --endevorh (string)

  • Endevor Rest API hostname.

• --endevor-port | --endevorp (number)

  • Endevor Rest API port.

• --endevor-user | --endevoru (string)

  • Mainframe (Endevor) username (can be the same as your TSO login).

• --endevor-password | --endevorpass | --endevorpw (string)

  • Mainframe (Endevor) password (can be the same as your TSO password).

• --endevor-reject-unauthorized | --endevorru (boolean)

  • Reject self-signed certificates.

    Default: true

• --endevor-base-path | --endevorbp (string)

  • The Endevor SCM Rest API base path.

    Default: EndevorService/rest

Endevor Bridge for Git connection options (you can also use an 'ebg' profile)

• --protocol | --prot (string)

  • Endevor Bridge for Git SCM protocol.

    Default: https

    Default value: https
    Allowed values: http, https

• --host | -H (string)

  • Endevor Bridge for Git hostname.

• --port | -P (number)

  • Endevor Bridge for Git port.

• --user | -u (string)

  • Endevor Bridge for Git username (your git username).

• --token | -t (string)

  • Git personal access token (Obtain the token from your Git Enterprise Server).

• --reject-unauthorized | --ru (boolean)

  • Reject self-signed certificates.

    Default: false

• --ebg-base-path (string)

  • The Endevor Bridge for Git Rest API base path.

Profile Options

• --ebg-profile | --ebg-p (string)

  • The name of a (ebg) profile to load for this command execution.

• --endevor-profile | --endevor-p (string)

  • The name of a (endevor) profile to load for this command execution.

• --base-profile | --base-p (string)

  • The name of a (base) profile to load for this command execution.

Base Connection Options

• --password | --pass | --pw (string)

  • Password to authenticate to service on the mainframe.

• --token-type | --tt (string)

  • The type of token to get and use for the API. Omit this option to use the default token type, which is provided by 'zowe auth login'.

• --token-value | --tv (string)

  • The value of the token to pass to the API.

• --cert-file (local file path)

  • The file path to a certificate file to use for authentication.

    Note: The CLI does not support certificate files that require a password. For more information, search Troubleshooting PEM Certificates in Zowe Docs.

• --cert-key-file (local file path)

  • The file path to a certificate key file to use for authentication

Examples

• Add a branch to my Git-Endevor mapping 'MY-CONTEXT / MY-MAPPING' using the default EBG and Endevor profile:

  • zowe endevor-bridge-for-git create branch MY-CONTEXT MY-MAPPING MY-BRANCH --endevor-environment ENVNAME --endevor-system SYSNAME --endevor-subsystem SUBNAME Copy

• Add a branch to my Git-Endevor mapping 'MY-CONTEXT / MY-MAPPING' using the default EBG and Endevor profile by using another branch as a template with different environment:

  • zowe endevor-bridge-for-git create branch MY-CONTEXT MY-MAPPING MY-BRANCH --like TEMPLATE_BRANCH --endevor-environment DIFFERENT_ENVIRONMENT Copy

• Add a branch to my Git-Endevor mapping 'MY-CONTEXT / MY-MAPPING' using the default EBG and Endevor profile by using another branch as a template with different system/subsystem:

  • zowe endevor-bridge-for-git create branch MY-CONTEXT MY-MAPPING MY-BRANCH --like TEMPLATE_BRANCH --endevor-system DIFFERENT_SYSTEM --endevor-subsystem DIFFERENT_SUBSYSTEM Copy