Command Line Interface for VMware vCloud Director
rocknes [VCDA-756] Limit keyring version to 12.0.0 to avoid installation fail…
…ures on linux. (#244)

Updated requirements.txt to limit version of keyring module to 12.0.0. Latest version of keyring module is causing installation failure on linux machines.

Tested on Windows, Linux, Mac and made sure that installation + commands work fine on these systems.
Latest commit 02fd459 Sep 20, 2018
Permalink
Failed to load latest commit information.
docs Fix venv activation command (#202) Mar 10, 2018
files Updated requirements with version info (#178) Jan 26, 2018
system_tests [VCDA-731] Create initial system tests for vcd-cli (#240) Sep 19, 2018
tests VCDA-441 list available storage profiles Jan 25, 2018
vcd_cli [VCDA-762] Fix confusing error message when non admin users invoke vc… Sep 19, 2018
.gitignore [VCDA-731] Create initial system tests for vcd-cli (#240) Sep 19, 2018
.gitlab-ci.yml gl-ci Sep 20, 2017
.travis.yml Updated travis ci (#171) Jan 23, 2018
AUTHORS Updated AUTHORS and ChangeLog for v20.3.0 (#224) Jun 15, 2018
CODE_OF_CONDUCT.md Add code of conduct and PR/issue templates Dec 20, 2017
CONTRIBUTING.md VCDA-477: Add doc for logging request headers and payload for debugg… Feb 15, 2018
ChangeLog Updated AUTHORS and ChangeLog for v20.3.0 (#224) Jun 15, 2018
Dockerfile docker Oct 11, 2017
Dockerfile.dev docker Oct 11, 2017
ISSUE_REQUEST.md Add code of conduct and PR/issue templates Dec 20, 2017
LICENSE.txt Updated license files (#199) Mar 9, 2018
MANIFEST.in Updated license files (#199) Mar 9, 2018
NOTICE.txt Updated license files (#199) Mar 9, 2018
PULL_REQUEST_TEMPLATE.md Add code of conduct and PR/issue templates Dec 20, 2017
README.md Updated license files (#199) Mar 9, 2018
cleanup.sh cleanup deprecated code; end-to-end tests Dec 21, 2017
format-code.sh VCDA-409: validate PEP8 compliance (#170) Jan 20, 2018
generate-docs.py new docs Sep 5, 2017
open_source_license_VMwarevCloudDirectorCLI20.2.0GA.txt Updated license files (#199) Mar 9, 2018
publish.sh cleanup deprecated code; end-to-end tests Dec 21, 2017
requirements.txt [VCDA-756] Limit keyring version to 12.0.0 to avoid installation fail… Sep 20, 2018
setup.cfg Updated AUTHORS, ChangeLog and requirements.txt. Removed forward slas… Jun 15, 2018
setup.py VCDA-454: Updated copyrights for release Feb 13, 2018
test-requirements.txt Update test-requirements.txt Jan 9, 2018
tox.ini VCDA-409: validate PEP8 compliance (#170) Jan 20, 2018

README.md

vcd-cli

License Stable Version Build Status

vcd-cli is the Command Line Interface for VMware vCloud Director.

Installation

In general vcd-cli can be installed with the following command:

$ pip install --user vcd-cli

Depending on your operating system and distribution you may need additional packages to install successfully. See install.md for full details.

Quick Start

Below is a sample vcd-cli interaction with vCloud Director to create a virtual machine and start using it.

Detailed command syntax and usage can be found in the vcd-cli site, along with the installation instructions.

    $ vcd login myserviceprovider.com org1 usr1 --password ******** -w -i
    usr1 logged in, org: 'org1', vdc: 'vdc1'

    $ vcd catalog create catalog1
    task: 893bff31-4bf6-48a6-84b8-55cee97e8349, Created Catalog catalog1(cc0a2b88-9e5a-4391-936f-df6e7902504b), result: success

    $ vcd catalog upload catalog1 photon-custom-hw11-2.0-304b817.ova
    upload 113,169,920 of 113,169,920 bytes, 100%
    property    value
    ----------  ----------------------------------
    file        photon-custom-hw11-2.0-304b817.ova
    size        113207424

    $ vcd vapp create vapp1 --catalog catalog1 --template photon-custom-hw11-2.0-304b817.ova \
      --network net1 --accept-all-eulas
    task: 0f98685a-d11c-41d0-8de4-d3d4efad183a, Created Virtual Application vapp1(8fd8e774-d8b3-42ab-800c-a4992cca1fc2), result: success

    $ vcd vapp list
    isDeployed    isEnabled      memoryAllocationMB  name      numberOfCpus    numberOfVMs  ownerName    status        storageKB  vdcName
    ------------  -----------  --------------------  ------  --------------  -------------  -----------  ----------  -----------  ---------
    true          true                         2048  vapp1                1              1  usr1         POWERED_ON     16777216  vdc1

    $ vcd vapp info vapp1
    property                     value
    ---------------------------  -------------------------------------
    name                         vapp1
    owner                        ['usr1']
    status                       Powered on
    vapp-net-1                   net1
    vapp-net-1-mode              bridged
    vm-1: 1 virtual CPU(s)       1
    vm-1: 2048 MB of memory      2,048
    vm-1: Hard disk 1            17,179,869,184 byte
    vm-1: Network adapter 0      DHCP: 10.150.221.213
    vm-1: computer-name          PhotonOS-001
    vm-1: password               ********

    $ ssh root@10.150.221.213
    ...

The OVA used in the example can be downloaded with the command:

   $ wget http://dl.bintray.com/vmware/photon/2.0/GA/ova/photon-custom-hw11-2.0-304b817.ova

Documentation

See the vcd-cli site for detailed documentation and installation instructions.

Please note that this project is under development, the commands, parameters and options might change over time.

vcd-cli uses pyvcloud, the Python SDK for VMware vCloud Director. It requires Python 3.

Previous versions and deprecated code can be found in this repository under tag 19.2.3.

Development

If you want to develop, follow these steps:

  • Fork the repository
  • Clone the forked respoitory
  • Install vcd-cli from the local sources pip3 install --user -e vcd-cli/
  • Add the path ~/.local/bin to the PATH

If you change the source, it is directly accessible with the vcd command

Contributing

The vcd-cli project team welcomes contributions from the community. Before you start working with vcd-cli, please read our Developer Certificate of Origin. All contributions to this repository must be signed as described on that page. Your signature certifies that you wrote the patch or have the right to pass it on as an open-source patch. For more detailed information, refer to CONTRIBUTING.md.

License

Apache-2.0