### Example Command Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/configurations/jfrog-platform-configuration.md An example of how to use the `exchange-oidc-token` command with various arguments and options. ```bash jf eot \ https://platform.jfrog.io \ $JFROG_CLI_OIDC_EXCHANGE_TOKEN_ID \ my-integration-name \ --oidc-audience=my-audience \ --oidc-provider-type=GitHub \ --application-key=my-app-key \ --project=my-project \ --repository=my-repo ``` -------------------------------- ### Install a plugin Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md Command to install a JFrog CLI plugin. ```bash $ jf plugin install the-plugin-name ``` -------------------------------- ### Plugin Descriptor YAML Example Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md An example of the YAML format for a plugin descriptor file, including mandatory and optional fields. ```yaml # Mandatory: pluginName: hello-frog version: v1.0.0 repository: https://github.com/my-org/my-amazing-plugin maintainers: - github-username1 - github-username2 # Optional: relativePath: build-info-analyzer # You may set either branch or tag, but noth both branch: my-release-branch tag: my-release-tag ``` -------------------------------- ### Oh My Zsh Plugin Example Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/shell-auto-completion.md Example of how to add 'jfrog' to the plugin list in your .zshrc file when using Oh My Zsh. ```shell plugins=(git mvn npm sdk jfrog) ``` -------------------------------- ### Go (JFrog CLI v1 - Legacy) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v1 (legacy) using Go. ```bash GO111MODULE=on go get github.com/jfrog/jfrog-cli; if [ -z "$GOPATH" ] then binPath="$HOME/go/bin"; else binPath="$GOPATH/bin"; fi; mv "$binPath/jfrog-cli" "$binPath/jfrog"; echo "$($binPath/jfrog -v) is installed at $binPath"; ``` -------------------------------- ### Example Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-platform-services/platform-workers-init.md Initialize a new BEFORE_DOWNLOAD worker named `my-worker`. ```bash jf worker init BEFORE_DOWNLOAD my-worker ``` -------------------------------- ### Build and run the template plugin Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md Commands to build and run the template plugin. ```bash $ cd jfrog-cli-plugin-template $ go build -o hello-frog $ ./hello-frog --help $ ./hello-frog hello --help $ ./hello-frog hello Yey! ``` -------------------------------- ### Distribution Rules Structure Example 2 (Wildcards) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md An example of the JSON structure for distribution rules using wildcards for site, city, and country codes. ```json { "distribution_rules": [ { "site_name": "", "city_name": "", "country_codes": ["*"] } ] } ``` -------------------------------- ### Distribution Rules Structure Example 1 Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md An example of the JSON structure for distribution rules, specifying sites, cities, and country codes. ```json { "distribution_rules": [ { "site_name": "DC-1", "city_name": "New-York", "country_codes": ["1"] }, { "site_name": "DC-2", "city_name": "Tel-Aviv", "country_codes": ["972"] } ] } ``` -------------------------------- ### Install with cUrl (JFrog CLI v2) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v2 using cURL. ```bash curl -fL https://install-cli.jfrog.io | sh ``` -------------------------------- ### Create Release Bundle v2 from Multiple Sources Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Example file spec for creating a Release Bundle v2 from multiple sources including builds, bundles, artifacts, packages, and an AQL query. ```json { "files": [ { "build": "Commons-Build/1.0.0", "includeDeps": "true", "project": "default" }, { "bundle": "rb1/1.0.0", "project": "default" }, { "bundle": "rb4/1.0.0", "project": "default" }, { "pattern": "catalina-dev-maven-local/*.jar" }, { "package": "commons", "version": "1.0.1", "type": "maven", "repoKey": "commons-dev-maven-local" }, { "package": "catalina", "version": "1.0.0", "type": "maven", "repoKey": "catalina-dev-maven-local" }, { "aql": { "items.find": { "repo": {"$eq": "catalina-dev-maven-local"}, "$and": [ {"name": {"$match": "*1.0.0.pom"}} ] } } } ] } ``` -------------------------------- ### NPM (JFrog CLI v1 - Legacy) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v1 (legacy) using NPM. ```bash npm install -g jfrog-cli-go ``` -------------------------------- ### Homebrew (JFrog CLI v2) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v2 using Homebrew. ```bash brew install jfrog-cli ``` -------------------------------- ### Debian Installer for JFrog CLI v2 Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md This bash script snippet is part of the Debian installation process for JFrog CLI v2, making the 'jf' executable available. ```bash # Create the keyrings directory if it doesn't exist sudo mkdir -p /usr/share/keyrings; ``` -------------------------------- ### NPM (JFrog CLI v2) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v2 using NPM. ```bash npm install -g jfrog-cli-v2-jf ``` -------------------------------- ### NPM (JFrog CLI v2 - Alternative) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Alternative method to install JFrog CLI v2 using NPM. ```bash npm install -g jfrog-cli-v2 ``` -------------------------------- ### Bash Auto-Completion Installation Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/shell-auto-completion.md Command to install JFrog CLI auto-completion for bash shells. ```shell jf completion bash --install ``` -------------------------------- ### Add Server with OIDC Authentication Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/configurations/jfrog-platform-configuration.md Example command to add a server using OIDC authentication. Requires --interactive=false and the JFROG_CLI_OIDC_EXCHANGE_TOKEN_ID environment variable to be set. ```bash jf c add \ --url=https://platform.jfrog.io \ --oidc-provider-name=setup-jfrog-cli-test \ --interactive=false ``` ```bash export JFROG_CLI_OIDC_EXCHANGE_TOKEN_ID= ``` -------------------------------- ### Example 2 Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Delete the distributions of the Release Bundle associated with project "proj" from the provided Edge nodes. Run the command synchronously and skip the confirmation message. ```bash jf rbd --dist-rules=/path/to/dist-rules.json --project="proj" --quiet --sync myApp 1.0.0 ``` -------------------------------- ### Fish Auto-Completion Installation Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/shell-auto-completion.md Command to install JFrog CLI auto-completion for fish shells. ```shell jf completion fish --install ``` -------------------------------- ### Docker (JFrog CLI v1 - Legacy) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Runs JFrog CLI v1 (legacy) images using Docker. ```bash Slim: docker run releases-docker.jfrog.io/jfrog/jfrog-cli jfrog -v Full: docker run releases-docker.jfrog.io/jfrog/jfrog-cli-full jfrog -v ``` -------------------------------- ### RPM (JFrog CLI v2 - Alternative) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Alternative method to install JFrog CLI v2 on RPM-based systems. ```bash echo "[jfrog-cli]" > jfrog-cli.repo; echo "name=jfrog-cli" >> jfrog-cli.repo; echo "baseurl=https://releases.jfrog.io/artifactory/jfrog-rpms" >> jfrog-cli.repo; echo "enabled=1" >> jfrog-cli.repo; rpm --import https://releases.jfrog.io/artifactory/jfrog-gpg-public/jfrog_public_gpg.key sudo mv jfrog-cli.repo /etc/yum.repos.d/; yum install -y jfrog-cli-v2; ``` -------------------------------- ### Zsh Auto-Completion Installation Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/shell-auto-completion.md Command to install JFrog CLI auto-completion for zsh shells. ```shell jf completion zsh --install ``` -------------------------------- ### Debian (JFrog CLI v2 - Alternative) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Alternative method to install JFrog CLI v2 on Debian-based systems. ```bash wget -qO - https://releases.jfrog.io/artifactory/jfrog-gpg-public/jfrog_public_gpg.key | sudo apt-key add - echo "deb https://releases.jfrog.io/artifactory/jfrog-debs xenial contrib" | sudo tee -a /etc/apt/sources.list; apt update; apt install -y jfrog-cli-v2; ``` -------------------------------- ### Docker (JFrog CLI v2 - Alternative) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Alternative method to run JFrog CLI v2 images using Docker. ```bash Slim: docker run releases-docker.jfrog.io/jfrog/jfrog-cli-v2 jfrog -v Full: docker run releases-docker.jfrog.io/jfrog/jfrog-cli-full-v2 jfrog -v ``` -------------------------------- ### Accessing plugin resources in code Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md Go code snippet demonstrating how to access the plugin's resources directory. ```go import ( "github.com/jfrog/jfrog-cli-core/v2/utils/coreutils" ) ... dir, err := coreutils.GetJfrogPluginsResourcesDir("my-plugin-name") ... ``` -------------------------------- ### Debian (JFrog CLI v2) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v2 on Debian-based systems using APT. ```bash wget -qO - https://releases.jfrog.io/artifactory/api/v2/repositories/jfrog-debs/keyPairs/primary/public | sudo gpg --dearmor -o /usr/share/keyrings/jfrog.gpg echo "deb [signed-by=/usr/share/keyrings/jfrog.gpg] https://releases.jfrog.io/artifactory/jfrog-debs focal contrib" | sudo tee /etc/apt/sources.list.d/jfrog.list sudo apt update; sudo apt install -y jfrog-cli-v2-jf; jf intro; ``` -------------------------------- ### Docker (JFrog CLI v2) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Runs JFrog CLI v2 images using Docker. ```bash Slim: docker run releases-docker.jfrog.io/jfrog/jfrog-cli-v2-jf jf -v Full: docker run releases-docker.jfrog.io/jfrog/jfrog-cli-full-v2-jf jf -v ``` -------------------------------- ### Powershell (JFrog CLI v2) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v2 on Windows using PowerShell. ```powershell powershell: "Start-Process -Wait -Verb RunAs powershell '-NoProfile iwr https://releases.jfrog.io/artifactory/jfrog-cli/v2-jf/[RELEASE]/jfrog-cli-windows-amd64/jf.exe -OutFile $env:SYSTEMROOT\system32\jf.exe'" ``` -------------------------------- ### RPM (JFrog CLI v1 - Legacy) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v1 (legacy) on RPM-based systems. ```bash echo "[jfrog-cli]" > jfrog-cli.repo; echo "name=jfrog-cli" >> jfrog-cli.repo; echo "baseurl=https://releases.jfrog.io/artifactory/jfrog-rpms" >> jfrog-cli.repo; echo "enabled=1" >> jfrog-cli.repo; rpm --import https://releases.jfrog.io/artifactory/api/v2/repositories/jfrog-rpms/keyPairs/primary/public; rpm --import https://releases.jfrog.io/artifactory/api/v2/repositories/jfrog-rpms/keyPairs/secondary/public sudo mv jfrog-cli.repo /etc/yum.repos.d/; yum install -y jfrog-cli; ``` -------------------------------- ### Debian (JFrog CLI v1 - Legacy) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v1 (legacy) on Debian-based systems. ```bash wget -qO - https://releases.jfrog.io/artifactory/api/v2/repositories/jfrog-debs/keyPairs/primary/public | sudo apt-key add - echo "deb https://releases.jfrog.io/artifactory/jfrog-debs xenial contrib" | sudo tee -a /etc/apt/sources.list; apt update; apt install -y jfrog-cli; ``` -------------------------------- ### Code Formatting Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md To ensure proper code formatting for your plugin, run this Go command from the root of your project directory. ```bash go fmt ./... ``` -------------------------------- ### RPM (JFrog CLI v2) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v2 on RPM-based systems using YUM. ```bash echo "[jfrog-cli]" > jfrog-cli.repo && echo "name=JFrog CLI" >> jfrog-cli.repo && echo "baseurl=https://releases.jfrog.io/artifactory/jfrog-rpms" >> jfrog-cli.repo && echo "enabled=1" >> jfrog-cli.repo && echo "gpgcheck=1" >> jfrog-cli.repo && # Import GPG keys for verifying packages # Note: Two keys are imported for backward compatibility with older versions rpm --import https://releases.jfrog.io/artifactory/api/v2/repositories/jfrog-rpms/keyPairs/primary/public && rpm --import https://releases.jfrog.io/artifactory/api/v2/repositories/jfrog-rpms/keyPairs/secondary/public && # Move the repository file to the YUM configuration directory sudo mv jfrog-cli.repo /etc/yum.repos.d/ && # Install the JFrog CLI package yum install -y jfrog-cli-v2-jf && # Display an introductory message for JFrog CLI jf intro ``` -------------------------------- ### File-Based Encryption Configuration Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/configurations/jfrog-platform-configuration.md Example of the security.yaml file structure for file-based encryption. ```yaml version: 1 masterKey: "your master key" ``` -------------------------------- ### Chocolatey (JFrog CLI v2 - Alternative) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Alternative method to install JFrog CLI v2 using Chocolatey. ```bash choco install jfrog-cli ``` -------------------------------- ### Download with cUrl (JFrog CLI v1 - Legacy) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Downloads JFrog CLI v1 (legacy) using cURL. ```bash curl -fL https://getcli.jfrog.io | sh ``` -------------------------------- ### Plugin executable path Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md Path where the plugin's executable should be placed for testing. ```text plugins/my-plugin/bin/ ``` -------------------------------- ### Plugin resources path Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md Path where external resources for the plugin should be placed for testing. ```text plugins/my-plugin/resources/ ``` -------------------------------- ### Download with Curl (JFrog CLI v2 - Alternative) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Alternative method to download JFrog CLI v2 using cURL. ```bash curl -fL https://getcli.jfrog.io/v2 | sh ``` -------------------------------- ### Download with cUrl (JFrog CLI v2) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Downloads JFrog CLI v2 using cURL. ```bash curl -fL https://getcli.jfrog.io/v2-jf | sh ``` -------------------------------- ### Publish a plugin to a private registry Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md Command to publish a plugin to a private JFrog CLI plugins registry. ```bash jf plugin publish the-plugin-name the-plugin-version ``` -------------------------------- ### Running Plugin Tests Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md The JFrog CLI Registry verifies plugins by attempting to run your plugin tests using this command. Ensure your tests are executed correctly. ```bash go vet -v ./... && go test -v ./... ``` -------------------------------- ### Sample Output Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/configurations/jfrog-platform-configuration.md A sample output format for the `exchange-oidc-token` command. ```json { "AccessToken": "****", "Username": "****" } ``` -------------------------------- ### Create a Release Bundle from existing builds and Release Bundles Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md This command demonstrates creating a Release Bundle that incorporates artifacts from both existing builds and existing Release Bundles. ```bash jf rbc rb3 1.0.0 --source-type-builds "name=Commons-Build, id=1.0.0, include-deps=true; name=Commons-Build, id=1.0.1" --source-type-release-bundles "name=rb1, version=1.0.0; name=rb2, version=1.0.0" ``` -------------------------------- ### Chocolatey (JFrog CLI v2) Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md Installs JFrog CLI v2 using Chocolatey. ```bash choco install: jfrog-cli-v2-jf ``` -------------------------------- ### Promote a Release Bundle Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Promotes a Release Bundle named 'myApp' version '1.0.0' to environment 'PROD' using the signing key pair 'myKeyPair'. ```bash jf rbp --signing-key=myKeyPair myApp 1.0.0 PROD ``` -------------------------------- ### Promote a Release Bundle Synchronously Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Promotes a Release Bundle synchronously to environment 'PROD', specifying the project 'project0' and using signing key pair 'myKeyPair'. ```bash jf rbp --signing-key=myKeyPair --project=project0 --sync=true myApp 1.0.0 PROD ``` -------------------------------- ### Create a Release Bundle using build name and build number variables Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md This command creates a Release Bundle using build information (name and number) as the source for artifacts. A signing key is also specified. ```bash jf rbc --build-name=Common-builds --build-number=1.0.0 myApp 1.0.0 ``` -------------------------------- ### Create Release Bundle v2 from AQL Query Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md File spec for creating a Release Bundle v2 from an AQL query. ```json { "files": [ { "aql": { "items.find": { "repo": "", "path": "", "name": "" } } } ] } ``` -------------------------------- ### Promote a Release Bundle Including Repositories Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Promotes a Release Bundle while including specific repositories 'generic-local' and 'my-repo'. ```bash jf rbp --signing-key=myKeyPair --include-repos="generic-local;my-repo" myApp 1.0.0 PROD ``` -------------------------------- ### Create a Release Bundle using file spec variables Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md This command creates a Release Bundle, specifying the source artifacts using a file spec and providing variable substitutions for customization. It also includes signing key information. ```bash jf rbc --spec=/path/to/spec.json --spec-vars="key1=value1" --signing-key=myKeyPair myApp 1.0.0 ``` -------------------------------- ### Create a Release Bundle synchronously Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md This command creates a Release Bundle synchronously within a specified project ('project0'). It requires a file spec for artifact definition and a signing key. ```bash jf rbc --spec=/path/to/spec.json --signing-key=myKeyPair --sync=true --project=project0 myApp 1.0.0 ``` -------------------------------- ### Distribute Release Bundle with Mapping Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Distribute the Release Bundle named myApp with version 1.0.0 using the default distribution rules. Map files under the `source` directory to be placed under the `target` directory. ```bash jf rbd --dist-rules=/path/to/dist-rules.json --mapping-pattern="(*)/source/(*)" --mapping-target="{1}/target/{2}" myApp 1.0.0 ``` -------------------------------- ### Create an access token for the user in the default server Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/configurations/jfrog-platform-configuration.md This command creates an access token for the user in the default server configured by the 'jf c add' command. ```bash jf atc ``` -------------------------------- ### List events supported by a server Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-platform-services/platform-workers-list-event.md Lists events supported by a server identified by `my-server`. ```bash jf worker list-event --server-id my-server ``` -------------------------------- ### Clone the plugin template repository Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md Command to clone the JFrog CLI plugin template repository. ```bash $ git clone https://github.com/jfrog/jfrog-cli-plugin-template.git ``` -------------------------------- ### Promote a Release Bundle Using Promotion Type Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Promotes a Release Bundle using the 'move' promotion type. ```bash jf rbp --signing-key=myKeyPair --promotion-type="move" myApp 1.0.0 PROD ``` -------------------------------- ### Create an access token for the user with a specific username Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/configurations/jfrog-platform-configuration.md This command creates an access token for the user with the specified username. ```bash jf atc toad ``` -------------------------------- ### Create a Release Bundle from multiple builds Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md This command creates a Release Bundle by aggregating artifacts from multiple specified builds. It includes options to include dependencies. ```bash jf rbc rb3 1.0.0 --source-type-builds "name=Commons-Build, id=1.0.0, include-deps=true; name=Commons-Build, id=1.0.1" ``` -------------------------------- ### Import Release Bundle v2 Archive Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Import a Release Bundle archive from a zip file. This is applicable in air-gapped environments on Edge nodes. ```bash jf rbi ./myExportedApp.zip ``` -------------------------------- ### Worker Execution History Example Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-platform-services/platform-workers-execution-history.md Retrieves the execution history of a worker named `my-worker` including test runs. ```bash jf worker execution-history --with-test-runs my-worker ``` -------------------------------- ### Create Release Bundle v2 from Published Build Info Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md File spec for creating a Release Bundle v2 from published build info. ```json { "files": [ { "build": "/", "includeDeps": "[true/false]", "project": "" }, ... ] } ``` -------------------------------- ### JFrog CLI Syntax for Release Lifecycle Management Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md The general syntax for using JFrog CLI with Release Lifecycle Management commands. ```bash $ jf command-name global-options command-options arguments ``` -------------------------------- ### JFrog CLI v2 Release Bundle Commands Replacement Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/get-started/download-and-install/install.md This snippet shows the replacement of deprecated release bundle commands in JFrog CLI v2. ```bash jfrog rt release-bundle-create jfrog rt release-bundle-delete jfrog rt release-bundle-distribute jfrog rt release-bundle-sign jfrog rt release-bundle-update ``` ```bash jfrog ds release-bundle-create jfrog ds release-bundle-delete jfrog ds release-bundle-distribute jfrog ds release-bundle-sign jfrog ds release-bundle-update ``` -------------------------------- ### Annotate Release Bundle v2: Replace Tag Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Replaces the existing tag of a Release Bundle v2 with a new tag 'rejected'. ```bash jf rba mybundle 1.0.0 --tag=rejected ``` -------------------------------- ### Checking Plugin Version Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-plugins/developer-guide.md You can check your plugin's version by running the plugin executable with the -v option. The version should have a 'v' prefix and follow semantic versioning. ```bash ./my-plugin -v ``` -------------------------------- ### Create a Release Bundle from multiple existing Release Bundles Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md This command creates a new Release Bundle by combining artifacts from multiple existing Release Bundles within a specified project. ```bash jf rbc rb3 1.0.0 --project catalina --source-type-release-bundles "name=rb1, version=1.0.0; name=rb2, version=1.0.0" ``` -------------------------------- ### Create Release Bundle v2 from Existing Release Bundles Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md File spec for creating a Release Bundle v2 from existing Release Bundles. ```json { "files": [ { "bundle": "/", "project": "" }, ... ] } ``` -------------------------------- ### Annotate Release Bundle v2: Replace Property Values Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Replaces the current values for the 'environment' property with 'DEV', 'PROD', and 'QA' for a Release Bundle v2. ```bash jf rba mybundle 1.0.0 --properties "environment=DEV,PROD,QA" ``` -------------------------------- ### Promote a Release Bundle Excluding Repositories Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md Promotes a Release Bundle while excluding specific repositories 'generic-local' and 'my-repo'. ```bash jf rbp --signing-key=myKeyPair --exclude-repos="generic-local;my-repo" myApp 1.0.0 PROD ``` -------------------------------- ### Deploy a worker to server with id my-server Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-platform-services/platform-workers-deploy.md Deploy a worker to server with id `my-server`. ```bash jf worker server deploy --server-id my-server ``` -------------------------------- ### Create Release Bundle v2 from Specified Package Source: https://github.com/jfrog/documentation/blob/main/jfrog-applications/jfrog-cli/cli-for-jfrog-artifactory/release-lifecycle-management.md File spec for creating a Release Bundle v2 from a specified package. ```json { "files": [ { "package": "catalina", "version": "1.0.0", "type": "maven", "repoKey": "catalina-dev-maven-local" } ] } ```