Update reno to 2.11.2

Issue: RELENG-1355
Change-Id: I2a194aa557a7a29ed4e70f084dd4255266ee29ab
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add cmd to clean up stale openstack heat stacks

Issue: RELENG-237
Change-Id: I8e2fcef93798395cc61f686a143ca3add5d081f2
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Fix typo in reorder-staged-repos help cmd

Strangely the docs builder is only catching this now.

Change-Id: I73b40d600183a8075f085a504c974a21e9daa31e
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Refactor the Jenkins object into a class

Make it easier for us to reuse the Jenkins instance in commands
outside of the jenkins command group.

Issue: RELENG-237
Change-Id: I2168adf9bc992b719da6c0350a446830015e6df6
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add token init cmd to add new server cfg

New token init command to automatically fetch API token and add new
server configuration section into jenkins_jobs.ini. This file should
already exist. This cmd uses the globally configured user credentials
in lftools.ini to initialize the new Jenkins server configuration.

Change-Id: I3d4bb0fd5696fd1bbeb26eb7d609bab5e064ba92
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add cmd to reset API tokens in jenkins_jobs.ini

Convenience command to automatically reset API tokens in
jenkins-jobs.ini.

Change-Id: I6d84760368b6a12e9e9622b5ce9496a278321dc4
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add jenkins token cmd to retrieve the API token

Change-Id: I43397d25978aaf752db33003044e7cb8d4884705
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge "Move JJB_INI to static variable"

Merge changes from topic 'share-cloud-images'

* changes:
  Add cmd to upload openstack images
  Add cmd to share openstack images

Merge "Enable universal wheel"

Move JJB_INI to static variable

We don't expect this location to change so set a static variable
that we can reuse more easily across modules.

Change-Id: Ieb54acc2d12de9bb21620112380f20be14fe9113
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Use logger instead of print in Jenkins CLI

Change-Id: I6e99c69f75a0be5c0e54da5c21a2930652ad3f8e
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Disable fast fail on parallel sigul

Sigul bridges seem to possibly have an issue with a lot of in parallel
signing requests. This is either an issue with the bridge, the server,
or a disconnected across the network VPN backhaul between the server and
bridge. Instead of having the signing just outright fail on the first
problem, we should try a few times.

Change-Id: I98a5c8adeb25e892899a221dc2078a9fc779f74e
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>

Enable universal wheel

lftools is Python 2 and 3 compatible so enable universal wheels.

Change-Id: I7a75f944030e35d4b021709700084abf11b6ae00
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add cmd to upload openstack images

Issue: RELENG-1201
Change-Id: I1f6072fbfff003a4602d3765a6a5ce7c94fe4c58
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add cmd to share openstack images

Allows us to more easily share images to multiple openstack tenants.

Issue: RELENG-1201
Change-Id: I58dc200f7b29429ee1215bacdc533d234ad153fb
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge "Use reno 2.10.0 and remove reno.yaml"

Remove prelude

This prelude did not make much sense for the patch the introduced it.

Change-Id: I8ccd3ba8ff02a43db043cfca842645dd1dccd89c
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Use reno 2.10.0 and remove reno.yaml

Reno 2.10.0 supports our regex pattern so we no longer need to
configure it.

Also add reno to tox so that people can run it via:

    tox -e reno new slug

Change-Id: Ic5f4de1af139e0cf99e955a30e3d957772563f57
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add npm metadata to .gitignore

Change-Id: Ifa5ebace74db851e00fb2431ef06f38952ec3e24
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge "Add stack create & delete commands"

Merge "Deduplicate test requirements"

Use logger instead of print in version module

Change-Id: I31329886088d8d7a469e19bc0937912546400109
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Update config subsystem to use logger

Use our logger service in the config subsystem.

Change-Id: I47235cf9accd362ba1355ff77e15757543d30da1
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Only print extra log details in DEBUG mode

This allow us to change all our print statements to log.info() and
have it still print sanely like a CLI application. Then when DEBUG
mode is enabled it will print the extra details to let us
troubleshoot. ERROR and CRITICAL logs will prefix with "ERROR: "
for example.

Change-Id: Ic35222ee654306e686052c209b641f9e49d38144
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge "Add support to jenkins cmd for jenkins_jobs.ini"

Merge "Add ruamel.yaml and yaml as known 3rdparty"

Merge "Enable or disable Jenkins jobs matching regex"

Enable or disable Jenkins jobs matching regex

ex:
To enable jobs

To disable jobs

JIRA: RELENG-1117
Change-Id: Iff800472cecfe056285f07e1c2461775457cb0ab
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>

Deduplicate test requirements

Some of these tests being pulled in are duplicates. Let's consolidate
into requirements-test.txt as the source of truth.

Change-Id: I2481a364b9ddf2aa0ba9e2168d4ee408ca477c43
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add support to jenkins cmd for jenkins_jobs.ini

Allow the jenkins command to use existing jenkins_jobs.ini for
configuration. By default assume jenkins_jobs.ini's default
configuration 'jenkins'.

This change makes 'server', 'user', and 'password' parameters no
longer required as defaults replace the need for these options.

'server' now defaults to 'jenkins' if jenkins_jobs.ini exists,
otherwise defaults to 'http://localhost:8080' which is the default
Jenkins deploy port.

'user' now defaults to 'admin' which is the Jenkins default admin
user.

'password' has no default and must be set by the user as this
is randomly generated by Jenkins at boot.

Change-Id: Ic7af1eb53e8e9079b845203f44914310616c4bab
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add ruamel.yaml and yaml as known 3rdparty

Change-Id: I954835b3e1a1700119d2e2328444b7794e7365fc
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Make ldap module optional

Install via 'pip install lftools[ldap]'.

Change-Id: Ie2206b43b094e1576936ba934268dc0b68fc5a40
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Remove summary/version which comes from PBR now

Change-Id: I19b0358a85beb281a07df1ef8ea84c8c7593927f
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge "Extend lftools with scripts for ldap lookups"

Add option to enable debug logs

Default the logger to INFO level and add an option to turn on DEBUG
level logs. Update the unit_tests to pass in a context since we need
it now in order to support the top-level configuration.

Change-Id: I253a127f7dc0cee5475d8403da8f82e018fdf36e
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Simplify logging configuration

lftools should be a simple tool and folks should not ever need to
configure the logger so let's simplify things and just pre-define
an acceptable logger configuration. The important component is
having (DEBUG) messages print via logger service. A subsequent
patch will be provided to enable --debug level logs via CLI.

Change-Id: I74158d94400112161ad4fc206426420d908deb0c
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add extras declaration in docs-linkcheck

This should have been added to
I1f33c65a44cf6eaa0e29e5734f3a8edcd8865868

Also include missing reno notes.

Change-Id: I132bebe298164419fae43e94299f43c45940bc4e
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Fix broken help from openstack and sign cmds

These were never caught since we did not enable fail on warnings
for Sphinx until recently.

Change-Id: I1f33c65a44cf6eaa0e29e5734f3a8edcd8865868
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add stack create & delete commands

Add 2 new commands:

    - stack create
    - stack delete

These commands allow lftools the ability to create and delete stacks.

Issue: RELENG-235
Change-Id: Ied7ff51a292199675dc944e36f1d821a5a2d045d
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Extend lftools with scripts for ldap lookups

Add 2 new commands to lftools:

    - infofile
    - ldap

prereqs:
For ldap lookups to work you must be on the VPN and have the cert
to get the cert: log in to any collab system and grab /etc/ipa/ca.crt
in /etc/openldap/ldap.conf

TLS_REQCERT always
TLS_CACERTDIR /etc/openldap/certs
TLS_CACERT /etc/openldap/certs/ca.crt

To test:

1. Clone this patchset
2. start venv

   pip uninstall lftools && pip install -e .

Usage:

$ lftools ldap
Usage: lftools ldap [OPTIONS] COMMAND [ARGS]...

  LDAP TOOLS.

Commands:
  autocorrectinfofile  Verify INFO.yaml against LDAP group.
  csv                  Query an Ldap server.
  inactivecommitters   Check committer participation.
  yaml4info            Build yaml of commiters for your INFO.yaml.

$ lftools infofile
Usage: lftools infofile [OPTIONS] COMMAND [ARGS]...

  INFO.yaml TOOLS.

Commands:
  get-committers    Extract Committer info from INFO.yaml or LDAP...
  sync-committers   Script to insert missing values from ldap...

Issue: RELENG-407
Change-Id: I4f4055441042d790008754bb085447f52e1c1a78
Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>

Use reno for release notes

Change-Id: Iadb0ca93a6f1f6a56c948b42bd257040547fffcc
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Setup PBR for lftools

Change-Id: I028540301560b76af1cb31f2d9c40612b3b3480f
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Remove unnecessary echo

Since Sphinx 1.7.x, Sphinx itself now prints the output location
at the end of a build so there's no need to do this unnecessary echo
anymore.

Change-Id: I517dea4686b68140be4ab672d6e909e446919163
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Bump to 0.16.0-dev

Change-Id: Ia255aefd6e1a05d2fb8440584406b6d8fbe5f2f3
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Release lftools v0.15.0

Change-Id: I3a3196f64cefabb390315a85e277d4652c9b30cb
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge "Handle snapshot artifacts in get_file_info()"

Handle snapshot artifacts in get_file_info()

This fixes lftools deploy maven-file to upload snapshot
artifacts to Nexus.

Issue: RELENG-1098
Change-Id: I5ed1c030b2b9c8f62e7f7e4ee0a63858782a747c
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>

Add utility to check repos for commits missing DCO

This only works on git repositories.

Change-Id: I45a0a66dfaaf517cdc5d85fc15f60e403bccfeb9
Co-Authored-By: Eric Ball <eball@linuxfoundation.org>
Co-Authored-By: Thanh Ha <thanh.ha@linuxfoundation.org>
Signed-off-by: Jeremy Phelps <jphelps@linuxfoundation.org>

Add optional classifier def to deploy cmd

The artifact/maven/content API supports an optional classifier
parameter so add option for it.

Change-Id: Ibf89ac2fb15e7fe289cb76aafad41936b24f3a9f
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add cURL command to push an artifact to Nexus

Issue: RELENG-1081
Change-Id: If36810924d2d0f91e04bae469067495a25c0b2dc
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Split Nexus staged repo create & close functions

Split out these functions so that they can be reused.

Issue: RELENG-1081
Change-Id: I5a5c2ee10ed98f7c0c25134298e5a10bb7b23dd1
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add pre-commit hook for trailing-whitespace

Install using tox:

    tox -e check-hooks

ref: https://pre-commit.com

Change-Id: I2423e9619870b1b97c0082cd54aad06479dcf172
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge "Bump version to 0.15.0-dev for next dev cycle"

Merge "Add options to continue interrupted downloads"

Bump version to 0.15.0-dev for next dev cycle

Change-Id: Ied5c6052b3fcede73129e8d5cb82f8bccea0afec
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Release lftools v0.14.0

Change-Id: I36f0364dfad341e00d9d381a5369622ced34bd23
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge "Add sigul signing capabilities to lftools"

Add sigul signing capabilities to lftools

Add in the ability to do sigul signing using lftools. This is an
extension of the current sign subcommand

Issue: RELENG-1070
Change-Id: Ie0cc0b2de0375f3c6306858a8ecb873e44888d42
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>

Add configuration subsystem

Create a basic ini based configuration subsystem
to be used in the future by lftools subsystems
as a single point of pulling configuration from.

Usage:

  lftools config get section [OPTION]
  lftools config set section option value

Example:

  lftools config set global username zxiiro
  lftools config get global

Issue: RELENG-915
Change-Id: I346662ae2c623538e8a6881574dad357a8ae4dee
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Update to python-jenkins 1.1.0

Pull in feature to detect groovy script failures allowing better
error detection and to actually return a proper error code when
a script fails.

Change-Id: I1e8735519060a024ab725373b3d76b11c89818d4
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Fix ShellCheck warnings for signing script

In prepration for adding sigul signing, the shellcheck warnings need to
be cleaned up

Change-Id: I27479a28f2a7898e489c8a2198ffbf8cdea0cbef
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>

Add options to continue interrupted downloads

Add support to continue interrupted downloads with
`lftools sign deploy-nexus`. This allows to continue partially
downloaded files and when used with user specified path (-d).

RELENG-929
Change-Id: I58b576cdcea370f4ae1386529b90130140d6840e
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>

Update Nexus string substition formating

Bring the string substitution formatting on Nexus code to the latest
standards for Python 3

Change-Id: I2c38cbbecc8b918aee968d46a12e251976cc8259
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>

Cleanup nexus repo command for Python 3

The original Nexus repo sub-command was written for Python 2 and needs
to be updated to work properly under Python 3.

Change-Id: I5558f833f4fc213e8eea64fc5a53ebcf1714d7be
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>

Merge "Add user-specified download path for lftools sign"

Add user-specified download path for lftools sign

Add a user-specified download location for lftools sign
deploy-nexus command. The default download location
is "/tmp/gpg-signatures.*" where '*' is random generated
suffix added to a directory name returned by mkdtemp()

Projects like ODL require more than 5 GiB free space
which might not be available in the returned path
therefore we should allow the user to use an alternative
download path.

ex:

lftools sign deploy-nexus -d <path> <URL> <repo> <profile-id>

JIRA: RELENG-928
Change-Id: I960e6c2dd5b5311ec0551834c6b96a297a2eb8bd
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>

Add remove-offline-nodes command

Migrates the 2 scripts for removing offline nodes from global-jjb
jenkins-admin into lftools.

https://github.com/lfit/releng-global-jjb/blob/v0.21.4/jenkins-admin/del_computer.groovy
https://github.com/lfit/releng-global-jjb/blob/v0.21.4/jenkins-admin/slay_computer.groovy

Change-Id: Ifb96689274d91d2655fe3fe1122856c82a3edaf2
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge "Add get-credentials groovy script to lftools"

Add Nexus tags

Fix first Nexus commands tag to remove namespace.
Add other needed tags for repo, create and reorder.

Change-Id: I187cca7d77227cf7fe7a42a7c46389cdd337f09c
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>

Add tag to Nexus docs

Add tag to Nexus commands documentation

Change-Id: Iba783cd83398d3ece0d73b94c8d2e716c35d5392
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>

Update Nexus settings example

Update Nexus settings.example.yaml file to match
the convention used in the public docs when referring to
a project's domain.
Also, update http to https.

Change-Id: I7cc2e717ba507ea7d7eee577de9744ee57b2e0fd
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>

Add get-credentials groovy script to lftools

This migrates the script in global-jjb into lftools as a command.

https://github.com/lfit/releng-global-jjb/blob/v0.21.4/jenkins-admin/get_all_creds.groovy

Change-Id: Ib60627e031b185b484ac0c3eeb99bf9d82470282
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Print result of groovy script to console

Change-Id: I84824c34c8d13df55a40b8409a9174055ab8e5a9
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Ignore protected images that are protected

Print a warning to inform the caller that we cannot delete
images that are protected.

Change-Id: I236f6f55964f483016500b58cbeb48fd8665b62b
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Pin python-jenkins to 0.4.16

It seems python-jenkins 1.0.0 broke the run_scripts() function which
we use to run the jenkins-cfg commands. Pin to the older version
until we figure out why.

Change-Id: I9e643e3aafbc9eb680fd3b8181a0d8b4806060ac
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Bump version to 0.14.0-dev

Change-Id: Ib4313b61d77593aa9c1cf4256aef5ceec1bc1941
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Release lftools v0.13.0

Change-Id: If195384c5e9c624d61aa7f1ecccf9268d134c1b3
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Simplify Nexus 2 repo target regex

Add unit test to check real world artifact paths against the regex
pattern.

Issue: RELENG-758
Change-Id: I580fef69ef03d9cf85c59da250fdfee66fcb7ad5
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Make OpenStack requirements optional

Users can now `pip install lftools[openstack]` as an optional
dependency so that we don't have to download the entire openstack
shade depchain.

Change-Id: Icf0065eeb1bf97f92560434edec3576397223af7
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge changes I84773de5,I91de27b2

* changes:
  Add test for latest upstream of dependencies
  Move tests requirements to separate file

Merge "Fail Sphinx build even on warnings"

Add test for latest upstream of dependencies

Useful for identifying potential issues if we were to bump versions
of upstream projects that we have pinned.

Change-Id: I84773de551f2bb882c14e5531657c0a37fce70c7
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Move tests requirements to separate file

Will be used later so we can add additional tests that depend on
this file.

Change-Id: I91de27b2024050894ba5ddeef5ec849074811f9b
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Remove trailing slashes in nexus_url

lftools should not fail if the user passes extra trailing slashes that
the command was not expecting.

Change-Id: I9a32c48ddd5ee2898816db7faaeb0de805a38b3c
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Merge "Pin requests and python-jenkins"

Add pytest cache to .gitignore

Change-Id: Ie3ff833149896f6beab8eb137f049a288538ff90
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Pin requests and python-jenkins

Change-Id: Ic830bad231d98efe721a299f18f634d87aad5e9f
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Fail Sphinx build even on warnings

Change-Id: I935e57b4536f58eb71b49d6558fefc170d50a8da
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Bump version to 0.13.0-dev

Change-Id: I8f643e0a9b6fefce7c723d4b46b955df4334dbb8
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Release lftools v0.12.4

Change-Id: If4fba3ca0b18bf785ed421ff42c20f20f608f9ca
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Fix remove volume time format

Created_at also uses a different time format that needs to be
addressed.

Change-Id: I5618a5f1ce3fdf0d49ce01cbad47683cf8e02762
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Bump version to 0.13.0-dev

Change-Id: Ie73dfc81edc257dea06450bd236d98746cd35290
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Release lftools v0.12.3

Change-Id: Ie38022c49c78a5a1ebe12ba596b339b3a9e110b7
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Fix volume remove command polling wrong metadata

Volumes use created_at instead of created.

Change-Id: I53a11dc791ee2d4035f9b641f97c019f2f19610f
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Bump version to 0.13.0-dev

Change-Id: Ice5411654c110e4630c1e8d95796c5bfa02f40b8
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Release lftools v0.12.2

Change-Id: I76af823e2c391e3ecf4ab7f5738a642cd554401f
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Add support for volume management

Issue: RELENG-853
Change-Id: Id412315238abfdea9f655dfeb2957964b37d5f19
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Bump version to 0.13.0-dev

Change-Id: Iac54f1c832e159fc960a18de4191052a67ba82dd
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>

Release lftools v0.12.1

Change-Id: I9aed03e79c38ef2823722e3a76be4bb45f47b549
Signed-off-by: Thanh Ha <thanh.ha@linuxfoundation.org>