Package: f5-cli
IntroductionThe F5 CLI provides a command-line interface (CLI) to various F5 products and services. It focuses primarily on facilitating consuming our most popular APIs and services, currently including BIG-IP (via Automation Tool Chain) and F5 Cloud Services.Similar to other popular cloud shells (for example, AWS CLI, Azure CLI, and Google gcloud), it is built on a python client library. For those looking to write custom automation scripts or workloads, one may choose to leverage the same python library it is built on (https://github.com/f5devcentral/f5-sdk-python).The F5 CLI is currently in early development and we want to hear from you! To provide feedback on CLI or this documentation, you can file aGitHub Issue.Benefits:Quickly access and consume F5’s APIs and Services with familiar remote CLI UXConfigurable settingsInclude common actions in Continuous Deployment (CD) pipelinesPrototypingTest calls that may be used in more complex custom integrations using the underlying SDKSupports discovery activities/querying of command-line results (for example, “list accounts” to find the desired account which will be used as an input to final automation)Support quick one-off automation activities (for example, leveraging a bash loop to create/delete large lists of objects)Table of ContentsQuick StartUser DocumentationQuick StartInstall F5 CLI with pippipinstallf5-cli
f5--helpRun F5 CLI in Docker containerExample: Run the F5 CLI with docker container interactivelydockerrun-it-v"$HOME/.f5_cli:/root/.f5_cli"-v"$(pwd):/f5-cli"f5devcentral/f5-cli:latest/bin/bashExample: Run the F5 CLI with docker container using an aliasaliasf5='docker run -it -v "$HOME/.f5_cli:/root/.f5_cli" -v "$(pwd):/f5-cli" f5devcentral/f5-cli:latest f5'Example: Run the F5 CLI with docker container from pathAnother shortcut to launch f5-cli is to assign a file containing the following content in your system's PATH (ex. cat /usr/local/bin/f5). This example also set environment variable to set the log level and disable ssl warnings of the application.#!/usr/bin bashdockerrun-it--rm-e"F5_SDK_LOG_LEVEL=INFO"-e"F5_DISABLE_SSL_WARNINGS=true"-v"$HOME/.f5_cli:/root/.f5_cli"-v"$(pwd):/f5-cli"f5devcentral/f5-cli:latestf5$@Notes:To post a declaration, make sure that the current directory is at where the declarative files are located. This will let the docker container to mount the local directory onto the container "$(pwd):/f5-cli" and process the declarative files with f5-cli container.Ensure that the config directory .f5_cli is mounted to the container so the container can authenticate and communicate properly with a target device.Build F5 CLI Docker container locallydockerbuild-tf5-cli:latest.User DocumentationSee thedocumentationfor details on installation, usage and much more.Source RepositorySee the source repositoryhere.Filing Issues and Getting HelpIf you come across a bug or other issue when using the CLI, useGitHub Issuesto submit an issue for our team.  You can also see the current known issues on that page, which are tagged with a Known Issue label.F5 CLI is community-supported. For more information, see theSupport page.CopyrightCopyright 2014-2020 F5 Networks Inc.F5 Networks Contributor License AgreementBefore you start contributing to any project sponsored by F5 Networks, Inc. (F5) on GitHub, you will need to sign a Contributor License Agreement (CLA).If you are signing as an individual, we recommend that you talk to your employer (if applicable) before signing the CLA since some employment agreements may have restrictions on your contributions to other projects. Otherwise by submitting a CLA you represent that you are legally entitled to grant the licenses recited therein.If your employer has rights to intellectual property that you create, such as your contributions, you represent that you have received permission to make contributions on behalf of that employer, that your employer has waived such rights for your contributions, or that your employer has executed a separate CLA with F5.If you are signing on behalf of a company, you represent that you are legally entitled to grant the license recited therein. You represent further that each employee of the entity that submits contributions is authorized to submit such contributions on behalf of the entity pursuant to the CLA.