releng/docs.git
3 years agoChore: Drop AVAILABILITY_ZONE 93/68293/2
Mohammed Naser [Wed, 14 Jul 2021 17:04:00 +0000 (13:04 -0400)]
Chore: Drop AVAILABILITY_ZONE

By default, OpenStack will schedule you into the right availablity
zone that has capacity, hard coding this can potentially result in
not being able to provision new virtual machines.

This patch drops the hard-wired value and lets Nova on the
scheduling size pick the correct availability zone.

Signed-off-by: Mohammed Naser <mnaser@vexxhost.com>
Change-Id: If962fb6c16905a57fb1548e6524badca41c1826c
Signed-off-by: Mohammed Naser <mnaser@vexxhost.com>
3 years agoDocs: Add auto-merge information 65/68165/3
Jessica Wagantall [Tue, 29 Jun 2021 00:13:28 +0000 (17:13 -0700)]
Docs: Add auto-merge information

Add information on how auto-merge works
for committer management and how to enable it.

Issue: RELENG-3774
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>
Change-Id: Ib55a7ab7ae4570aa5b1aa852ff417f115feafd2d

3 years agoDocs: Update IRC chat locations 25/68025/2
Guillaume Lambert [Tue, 15 Jun 2021 19:12:22 +0000 (21:12 +0200)]
Docs: Update IRC chat locations

Freenode IRC channels locations are no more reachable.
Official LFN channels have migrated to Libera.Chat.

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I30336fb4456eb15c63930dcca0a0d62c063996fb

3 years agoCI: Ignore docker.io registry linkcheck failure 26/68026/1
Guillaume Lambert [Tue, 15 Jun 2021 19:28:11 +0000 (21:28 +0200)]
CI: Ignore docker.io registry linkcheck failure

https://registry-1.docker.io root page now returns a 404 error code.
Though, other pages in the tree are still reachable.

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Id680f556b5ad163677d926a6ad0f28b608b13b98

3 years agoFix: Correct path location for managed configs 53/67953/1
Andrew Grimberg [Thu, 10 Jun 2021 16:47:06 +0000 (09:47 -0700)]
Fix: Correct path location for managed configs

The defined path for JCasC managed config files was pointing into a
directory that we do not use. It should be jenkins-config not
jenkins-admin

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

3 years agoDocs: Add Managed Config Files documentation 13/67913/5
Andrew Grimberg [Tue, 8 Jun 2021 18:50:46 +0000 (11:50 -0700)]
Docs: Add Managed Config Files documentation

Issue: RELENG-3723
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
Change-Id: Ibf62456b748f150cdf491ffe793bfaee1925c9c2
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
3 years agoDocs: Add more build agent links 59/67859/2
Andrew Grimberg [Wed, 2 Jun 2021 21:05:47 +0000 (14:05 -0700)]
Docs: Add more build agent links

Add in more links to the build agent definitions for our projects.

Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
Change-Id: I37df350eac0a92404470f1b67fc4a17be32e5620
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
3 years agoRefactor: Reword from minion to agent 53/67853/2
Andrew Grimberg [Wed, 2 Jun 2021 18:14:39 +0000 (11:14 -0700)]
Refactor: Reword from minion to agent

The official Jenkins terminology has shifted from slave to agent. We
used minion as our term while the Jenkins project was continuing to use
the term slave. Now that they have a less offensiv official term it's
best for us to shift back to what the upstream term is.

Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
Change-Id: I1b99f56d0ed66239a5d71b0e4943e24227455fc8
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
3 years agoDocs: Improve best practices content 24/67624/11
Guillaume Lambert [Fri, 7 May 2021 13:48:10 +0000 (15:48 +0200)]
Docs: Improve best practices content

- fix a typo
- make conventional commit format use optional
- precise first paragraph content
- mention ChangeLog

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I891b6aa55bdde69a605aa35e84af3d5e7506b5ba

3 years agoMerge changes from topic "bestpractices"
Andrew Grimberg [Mon, 10 May 2021 16:53:13 +0000 (16:53 +0000)]
Merge changes from topic "bestpractices"

* changes:
  CI: Replace a deprecated method in docs/conf.py
  CI: Decrease Sphinx tox profiles logs verbosity

3 years agoCI: Properly run gitlint in CI 56/67656/1
Andrew Grimberg [Mon, 10 May 2021 16:14:15 +0000 (09:14 -0700)]
CI: Properly run gitlint in CI

When running pre-commit in a CI system the COMMIT_EDITMSG does not
(normally) get created as that is an artifact of editing the commit
message. If the file doesn't exist then gitlint will skip which makes it
possible for pre-commit checks that should fail, to pass.

Since we want tox to run in a consistent manner both locally and in CI
we need to play around a little with how we are checking the commit
message.

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

3 years agoCI: Replace a deprecated method in docs/conf.py 26/67626/3
Guillaume Lambert [Fri, 7 May 2021 14:21:53 +0000 (16:21 +0200)]
CI: Replace a deprecated method in docs/conf.py

Sphinx method add_stylesheet() is deprecated.
It now generates warnings at buildtime.
The method add_css_file() must be used instead.

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: I5ddba780dd649d840ef7bf070b48bf771c9f8888

3 years agoCI: Decrease Sphinx tox profiles logs verbosity 25/67625/3
Guillaume Lambert [Fri, 7 May 2021 14:14:56 +0000 (16:14 +0200)]
CI: Decrease Sphinx tox profiles logs verbosity

Docs and docs-linkcheck tox profiles are using Sphinx that generates
very verbose logs by default.
Sphinx -q quiet option allow to display only errors and warnings.
Using this option will ease potential gate failures analysis.

Signed-off-by: Guillaume Lambert <guillaume.lambert@orange.com>
Change-Id: Ib6b4096df9cb58fe7ad46b790a8455fb4808e26e

3 years agoCI: Configure gitlint for Conventional Commits 34/67634/1
Andrew Grimberg [Fri, 7 May 2021 18:54:53 +0000 (11:54 -0700)]
CI: Configure gitlint for Conventional Commits

Turn on Conventional Commit message subject validation. This will affect
CI specifically, but developers can avoid having CI fail by assuring
that they have installed pre-commit and that they have also run

pre-commit install --hook-type commit-msg

The above is needed because pre-commit does not install commit-msg hooks
by default

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

3 years agoCI: Update pre-commit versions 33/67633/1
Andrew Grimberg [Fri, 7 May 2021 18:50:36 +0000 (11:50 -0700)]
CI: Update pre-commit versions

Update versions of checks being used by pre-commit

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

3 years agoUpdate inventory page with DENT Jira link 67/67567/1
Anil Belur [Mon, 3 May 2021 23:26:26 +0000 (09:26 +1000)]
Update inventory page with DENT Jira link

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

3 years agoMerge "Decommission ODL sonarqube"
Andrew Grimberg [Mon, 3 May 2021 15:17:26 +0000 (15:17 +0000)]
Merge "Decommission ODL sonarqube"

4 years agoDocs: Add Conventional Commit specification links 02/67502/1
Andrew Grimberg [Fri, 23 Apr 2021 16:44:15 +0000 (09:44 -0700)]
Docs: Add Conventional Commit specification links

While creating a Current Best Practices presentation for some Computer
Science students I stumbled upon references to Semantic Commit Messages.

Upon further reading on the subject I believe that this is a new
practice that we should be recommending to communities. There seems to
be a rabbit hole of references on it, so I'm only recommending the two
that seem to give the best results. In particular the Gist has continued
discussion even after the initial posting on May 15, 2017.

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

4 years agoDecommission ODL sonarqube 01/67501/1
Anil Belur [Fri, 23 Apr 2021 03:28:37 +0000 (13:28 +1000)]
Decommission ODL sonarqube

Remove the URL from the docs inventory.

Issue: INFRA-6531
Change-Id: Ifa20a0cd06e439a22564ea0e80e9ae4a8e8c8135
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
4 years agoAdd workaround for GH black stable branch 10/67310/2
Anil Belur [Fri, 2 Apr 2021 21:48:48 +0000 (07:48 +1000)]
Add workaround for GH black stable branch

The 'stable' branch on black repo has been removed.
Add workaround to point to branch/rev to '20.8b1'
until the issue is resolved.

Update broken link.

GH Issue: https://github.com/psf/black/issues/2079
Change-Id: Ide90eecd3d0a5175a0a67568dbca87a3f8fd7c99
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
4 years agoUpdate to v3 flavors in examples 07/66807/1
Anil Belur [Wed, 17 Feb 2021 23:46:43 +0000 (09:46 +1000)]
Update to v3 flavors in examples

Change-Id: Ib4592b9f50c593cd36493502698d03b97c92d079
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
4 years agoUse the default version as python3 06/66806/1
Anil Belur [Thu, 28 Jan 2021 23:21:02 +0000 (09:21 +1000)]
Use the default version as python3

Change-Id: I10304f8814aefd3a4d104aeb2d8a657b3b3e9354
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
4 years agoUpdate analytics dashboard links 57/66057/2
Andrew Grimberg [Thu, 12 Nov 2020 18:22:24 +0000 (10:22 -0800)]
Update analytics dashboard links

With the rebrand to LFX the URLs have all been changed for
lfanalytics.io. While there is a redirect in place it breaks for many of
the URLs because of %2F in the URI and a bug at DNSimple.

Instead of relying on the redirect, we should have the dashboards linked
properly

Additionally update Acumos Sonar link to only be SonarCloud

Change-Id: Ia122a52d9d7df23ba0570952e68af744bcf4a533
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
4 years agoSwitch write-good to upstream hook 44/66244/8
Anil Belur [Mon, 7 Dec 2020 08:58:45 +0000 (18:58 +1000)]
Switch write-good to upstream hook

- Upstream PR [1.] is merged fixes issues with the
write-good npm dependencies.
- Update inventory page for DENT project
- Acumos sonar is mmoved to sonarcloud.io.
- Update dead links.

Issue: RELENG-3257
[1.] https://github.com/btford/write-good/pull/126
Change-Id: I233f645195dcf0964effae1176ca3956d4c53380
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
4 years agoProject creation via INFO file docs 86/62386/15
Aric Gardner [Fri, 22 Nov 2019 21:02:57 +0000 (16:02 -0500)]
Project creation via INFO file docs

JIRA: RELENG-1027
Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: I87af7649e1ef4b3c2cc5e2326bec49fe4fbccd92

4 years agoFix gerrit link in docs. 18/65218/1
Aric Gardner [Thu, 27 Aug 2020 19:48:44 +0000 (15:48 -0400)]
Fix gerrit link in docs.

https://code.google.com/p/gerrit/ redirects to
https://bugs.chromium.org/p/gerrit/issues/list

Also it is the wrong place to go for more info.

Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: I1226b1c7eef2c2ac7d8f9bbcddc23801eea91647

4 years agoRestore write-good lint checker 72/64972/2
Thanh Ha [Sat, 8 Aug 2020 19:42:18 +0000 (15:42 -0400)]
Restore write-good lint checker

Change I9bf03d36b9c17b261ef83140cd7e9c2ddf5caba1 removed the write-good
linter without a replacement. This patch restores the linter back by
migrating it to be a pre-commit hook instead.

This also rewrites the generic linter best practice section to
recommend pre-commit instead as we are no longer supporting Coala.

Issue: RELENG-2642
Change-Id: I698df0f68cbea80f43b29e3ae7563d2dc38951e9
Signed-off-by: Thanh Ha <zxiiro@gmail.com>
4 years agoMigrate all Python linters to pre-commit 71/64971/1
Thanh Ha [Sat, 8 Aug 2020 19:32:43 +0000 (15:32 -0400)]
Migrate all Python linters to pre-commit

Switch Python related Coala linters over to pre-commit hooks. We would
like to migrate off of the Coala platform as it has not had a release
in years.

Issue: RELENG-2642
Signed-off-by: Thanh Ha <zxiiro@gmail.com>
Change-Id: I1a20839a070b9923f72ac86317b8b5d9889ebe9f

4 years agoList of Gerrit Github mirrors 36/64936/6
Aric Gardner [Wed, 5 Aug 2020 20:19:14 +0000 (16:19 -0400)]
List of Gerrit Github mirrors

Add github mirrors when applicable for all projects

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

4 years agoRemove biterg.io links 50/64950/4
Aric Gardner [Thu, 6 Aug 2020 17:42:35 +0000 (13:42 -0400)]
Remove biterg.io links

as of July 31 no LFN project has biterg.io dashboards
switch out for https://lfanalytics.io/ where applicable

Also fix fdio sonar cloud link.
also move tf link to insights section
and remove broken link from stats section

Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: I44bf703949f6393261261d971298b701f947d501

4 years agoInital text for Gerrit Prolog Filter 12/64612/6
Bengt Thuree [Thu, 23 Jul 2020 06:40:56 +0000 (16:40 +1000)]
Inital text for Gerrit Prolog Filter

Issue: RELENG-1995
Change-Id: I1a4b30b3ea172479290a8996108e01ca84c7888b
Signed-off-by: Bengt Thuree <bthuree@linuxfoundation.org>
4 years agoRemove testenv:coala 19/63919/4
Aric Gardner [Thu, 7 May 2020 20:11:03 +0000 (16:11 -0400)]
Remove testenv:coala

pre-commit is better and properly maintained
we lose the writegoodbear but I would argue that
enforcing this bear doesn't make sense.
no replacement has been found for it.

Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: I9bf03d36b9c17b261ef83140cd7e9c2ddf5caba1

4 years agoJenkins Build Failure Analyzer info 35/64535/6
Jessica Wagantall [Wed, 15 Jul 2020 20:18:48 +0000 (13:18 -0700)]
Jenkins Build Failure Analyzer info

Add information on how to use the Build
Failure Analyzer plugin for Jenkins

Issue: RELENG-3067
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>
Change-Id: I026c98ed94352c21030587b64bf1909fc9322473

4 years agoRemove sonar.onap.org 36/64536/2
Jessica Wagantall [Wed, 15 Jul 2020 20:49:07 +0000 (13:49 -0700)]
Remove sonar.onap.org

sonar.onap.org is no longer part of the
inventory for ONAP as it is replaced by
SonarCloud.

Issue: RELENG-3060
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>
Change-Id: I68f2e0b8074208ac3d1759e2af34f0772c476ab9

4 years agoAdd sample and restrictions for INFO file 00/64400/4
Bengt Thuree [Thu, 2 Jul 2020 00:26:54 +0000 (10:26 +1000)]
Add sample and restrictions for INFO file

Added some lint check, and restriuction samples for the INFO file

Issue-ID: RELENG-2878

Signed-off-by: Bengt Thuree <bthuree@linuxfoundation.org>
Change-Id: If45512331cfd139cda1ffc71a8571206b3e65fb7

4 years agoMerge "Update pre-commit hooks 2020-06"
Andrew Grimberg [Sat, 6 Jun 2020 14:25:19 +0000 (14:25 +0000)]
Merge "Update pre-commit hooks 2020-06"

4 years agoUpdate pre-commit hooks 2020-06 22/64222/1
Thanh Ha [Sat, 6 Jun 2020 13:57:53 +0000 (09:57 -0400)]
Update pre-commit hooks 2020-06

It's been awhile since we last updated pre-commit hooks so let's
catch up with the world.

Signed-off-by: Thanh Ha <zxiiro@gmail.com>
Change-Id: I3c6a29d6e2ad4baf74b53ee3476482803b41f3cf

4 years agoSetup gitlint for linting commits 21/64221/1
Thanh Ha [Sat, 6 Jun 2020 13:57:03 +0000 (09:57 -0400)]
Setup gitlint for linting commits

Setup gitlint to lint commit messages in this repo.

Signed-off-by: Thanh Ha <zxiiro@gmail.com>
Change-Id: Ia93eacc169cfb5cf0b071f4ada483e914b36b481

4 years agoPrint git-diff when pre-commit fails 20/64220/2
Thanh Ha [Sat, 6 Jun 2020 13:54:01 +0000 (09:54 -0400)]
Print git-diff when pre-commit fails

When pre-commit fails and automatically fixes issues for us in Jenkins
we are not able to see what pre-commit automatically fixed. Adding
--show-diff-on-failure makes pre-commit perform a git-diff immediately
after failing to ensure more useful output is printed to inform the
contributor what changes are needed to pass the check.

Signed-off-by: Thanh Ha <zxiiro@gmail.com>
Change-Id: Ia291e121a0882374e1f13180a237f89bde9be68b

4 years agoremove nexus.aswf.io, already decommed 99/64199/3
Daniel Pono Takamori [Thu, 4 Jun 2020 16:24:28 +0000 (09:24 -0700)]
remove nexus.aswf.io, already decommed

Change-Id: Ieac8c4578eda74b3086becceb3324481cce43180
Signed-off-by: Pono <dtakamori@contractor.linuxfoundation.org>
4 years agoUpdate inventory page with ODLs sonarcloud link 20/64020/1
Anil Belur [Mon, 18 May 2020 05:52:17 +0000 (15:52 +1000)]
Update inventory page with ODLs sonarcloud link

Change-Id: I99ac923e60f1306c32bff1dd9134252e6cfad3a1
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
4 years agochange fdio datadoge link 72/63972/2
Daniel Pono Takamori [Tue, 12 May 2020 18:41:02 +0000 (11:41 -0700)]
change fdio datadoge link

also fix nexus doc link

Change-Id: Iae2d650854bd7a0b6779d31a2be772353b09e0a3
Signed-off-by: Daniel Pono Takamori <dtakamori@contractor.linuxfoundation.org>
4 years agoAdd build logs column 02/63902/1
Andrew Grimberg [Wed, 6 May 2020 18:44:59 +0000 (11:44 -0700)]
Add build logs column

With the advent of the S3 log shipping that Zowe is using it seems wise
to add a new column that states all of the places that build logs are
stored or if we even store logs for a project.

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

5 years agoAdd LF Edge Github and Jenkins to inventory 78/63378/1
Eric Ball [Wed, 11 Mar 2020 19:35:07 +0000 (12:35 -0700)]
Add LF Edge Github and Jenkins to inventory

Change-Id: Icf2384d6628dff6e34cd3c48cc0ac0aff60fe203
Signed-off-by: Eric Ball <eball@linuxfoundation.org>
5 years agoRemove AGL sandbox link from inventory 56/63156/1
Anil Belur [Thu, 20 Feb 2020 12:09:59 +0000 (22:09 +1000)]
Remove AGL sandbox link from inventory

AGL sandbox does not exist on infra anymore.

Change-Id: Id3518c6655341c7e4818b0f0d4d72baeb1e2e499
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
5 years agoUpdate HYP Gerrit with GH link 13/63013/2
Anil Belur [Mon, 3 Feb 2020 10:23:46 +0000 (20:23 +1000)]
Update HYP Gerrit with GH link

The Gerrit service is no longer active for HYP and has been
moved to GH.

Also update a broken link in the docs.

Change-Id: I8aa4b4b5d5fe4d96e05450dad62a78278e3a2f48
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
5 years agoMerge "add tf dev analytics and zowe artifactory links"
Andrew Grimberg [Fri, 31 Jan 2020 20:36:01 +0000 (20:36 +0000)]
Merge "add tf dev analytics and zowe artifactory links"

5 years agoRemove HYP Nexus 2/3 from inventory 78/62878/2
Anil Belur [Thu, 23 Jan 2020 07:15:54 +0000 (17:15 +1000)]
Remove HYP Nexus 2/3 from inventory

HYP Nexus 2/3 nodes will be decommission from Feb/01/2020.

Issue: IT-18761
Change-Id: I15ec40c57a62a0ff36580c4d4ebe88f200059c1e
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
5 years agoRemove Sonar for Akraino 80/62880/1
Anil Belur [Thu, 23 Jan 2020 09:19:01 +0000 (19:19 +1000)]
Remove Sonar for Akraino

Akraino is migrated to sonarcloud.io

Issue: RELENG-2409
Change-Id: I4a2f010936e40c3bbb055c15445def944cb1c32c
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
5 years agoadd tf dev analytics and zowe artifactory links 67/62767/1
Daniel Pono Takamori [Thu, 9 Jan 2020 18:33:56 +0000 (10:33 -0800)]
add tf dev analytics and zowe artifactory links

Change-Id: I3752cd9f08bed90ac0db5f9d927ffd74feabbc68
Signed-off-by: Pono <dtakamori@contractor.linuxfoundation.org>
5 years agoRemove IoTivity information 30/62730/1
Andrew Grimberg [Mon, 6 Jan 2020 18:51:00 +0000 (10:51 -0800)]
Remove IoTivity information

IoTivity has exited LF support and as such we need to remove links from
the inventory.

Issue: INFRA-4958
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
Change-Id: I5f1021734f460506201476415fc85d366dbcb1e9

5 years agoRemove jenkins.hyperledger.org/sandbox 91/62591/1
Aric Gardner [Tue, 10 Dec 2019 19:15:40 +0000 (14:15 -0500)]
Remove jenkins.hyperledger.org/sandbox

This machine has been turned off.

Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: I2bf9e79600dbccc4c31e8122f1b2065c0ca0094c

5 years agoMerge "Docs on Committer management"
Andrew Grimberg [Fri, 22 Nov 2019 20:50:23 +0000 (20:50 +0000)]
Merge "Docs on Committer management"

5 years agoMerge "Add link defs to sections"
Andrew Grimberg [Fri, 22 Nov 2019 20:04:46 +0000 (20:04 +0000)]
Merge "Add link defs to sections"

5 years agoDocs on Committer management 85/62385/2
Aric Gardner [Fri, 22 Nov 2019 19:46:55 +0000 (14:46 -0500)]
Docs on Committer management

Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: Ie41c0fe17cff686b3c733186f7d0b33b2d586fc1

5 years agoAdd Block about rebasing a change. 81/62381/3
Aric Gardner [Fri, 22 Nov 2019 17:58:24 +0000 (12:58 -0500)]
Add Block about rebasing a change.

I think this is an used enough idiom
for it to warrent inclusion in the gerrit doc.

Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: I5664064f90f143540dfb3e97e0d9c5bd5383366f

5 years agoRemove broken links. 83/62383/2
Aric Gardner [Fri, 22 Nov 2019 18:51:40 +0000 (13:51 -0500)]
Remove broken links.

ODPI Transformation to AZP
info in issue linked.

remove decommissioned
https://nexus3.aswf.io

JIRA: INFRA-4920
Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: I3910fd0f8129bc82a62121cddf09dbca00ed2cbd

5 years agoAdd link defs to sections 29/62129/2
Thanh Ha [Thu, 31 Oct 2019 21:37:53 +0000 (17:37 -0400)]
Add link defs to sections

Add link definitions to the Jenkins sections so that we can
intersphinx link to them in downstream docs.

Signed-off-by: Thanh Ha <zxiiro@gmail.com>
Change-Id: Icee5bd3bfaefc6be33fec57747f22937cead81dd

5 years agoAdd missing SonarCloud entries 19/62119/1
Andrew Grimberg [Wed, 30 Oct 2019 23:34:29 +0000 (16:34 -0700)]
Add missing SonarCloud entries

Change-Id: I624b2447d0441cdc7666bad9f87917ba2b95f945
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoUpdate sandbox test steps to use python3 58/61958/4
Anil Belur [Thu, 17 Oct 2019 10:12:19 +0000 (15:42 +0530)]
Update sandbox test steps to use python3

By default virtualenv uses python2.7 which is going
to be EOL soon.

Change-Id: Ic06458f963deb276321299721c7a31291cf41bbd
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
5 years agoAdd additional reading about good git messages 62/62062/1
Andrew Grimberg [Mon, 21 Oct 2019 19:16:33 +0000 (12:16 -0700)]
Add additional reading about good git messages

Since we like to give as many sources of good content as possible when
it comes to commit messages, another blog post was recently written and
brought brought to my attention. It's got additional links to some more
good content.

In this case it goes into detail on what a really good message looks
like, why it's good. For instance, it explains the reason behind the
change and all the work done to implement it along with giving learning
examples.

Change-Id: Id4fef32e15beededb6c13197d8e85922c5e808a9
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoRemove ASWF Jenkins references 58/62058/1
Andrew Grimberg [Mon, 21 Oct 2019 19:06:07 +0000 (12:06 -0700)]
Remove ASWF Jenkins references

The ASWF TAC voted to retire the Jenkins environment. Operations has
completed decommission of the Jenkins and Jenkins Sandbox. Since we do
link checking, we need to remove those links from our inventory along
with the defunct DataDog link.

Change-Id: Iebaafeffc1c010773d98d35255398d5fbe65b4b1
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoMerge "Add SSH Guide on how to generate SSH keys"
Milin Jaiswal [Thu, 29 Aug 2019 15:31:49 +0000 (15:31 +0000)]
Merge "Add SSH Guide on how to generate SSH keys"

5 years agoAdd AZP locators for ASWF and ODPi (Egeria) 19/61519/3
Andrew Grimberg [Wed, 28 Aug 2019 18:42:06 +0000 (11:42 -0700)]
Add AZP locators for ASWF and ODPi (Egeria)

* Switch column header to be more CI agnostic
* Add links to the Azure Pipelines for ASWF and ODPi in prepration for
  when we depcrecate the Jenkins environments
* Fix all CI platform links to be line blocks to ensure each listed
  CI is on a separate line in the row/column block

Change-Id: I13081c63ffdf2fdb33575340d2a02318ec6c77ce
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoAdd SSH Guide on how to generate SSH keys 95/16495/4
Milin [Thu, 8 Aug 2019 22:12:37 +0000 (17:12 -0500)]
Add SSH Guide on how to generate SSH keys

Add "How to generate SSH Keys" guide to LF docs for anonymous users.

Issue: RELENG-562
Signed-off-by: Milin <mjaiswal@contractor.linuxfoundation.org>
Change-Id: I52bc7d35727138f5300f7d7e696c3bad17b8c2e0

5 years agoConfigure basepython to python3 09/16709/1
Thanh Ha [Tue, 27 Aug 2019 19:15:15 +0000 (15:15 -0400)]
Configure basepython to python3

More and more libraries that we are pulling in require Python 3 so
to avoid having to play the pin dependencies whack-a-mole game let's
bump or base python where possible to python3.

This also renames the pre-commit env to the standard "pre-commit" name
that we use in other projects.

Signed-off-by: Thanh Ha <zxiiro@gmail.com>
Change-Id: Id39458360af83668d41d61eb3185fdde0894f3f7

5 years agoUpdate sonarcloud inventory 90/16690/2
Suresh Channamallu [Tue, 27 Aug 2019 15:04:44 +0000 (11:04 -0400)]
Update sonarcloud inventory

Replace sonarqube to sonarcloud in inventory list

Issue: RELENG-2336
Signed-off-by: Suresh Channamallu <schannamallu@linuxfoundation.org>
Change-Id: I9db66470a15cb6ed6d611826277c8df9092d50e8

5 years agoPin more-itertools~=5.0.0 92/16692/1
Anil Belur [Tue, 27 Aug 2019 16:16:15 +0000 (21:46 +0530)]
Pin more-itertools~=5.0.0

Change-Id: Ic4a6c25c719a96471aeccef18732f92b4a8ce96c
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
5 years agoRemove extra DataDog link for ASWF 20/16620/1
Andrew Grimberg [Tue, 20 Aug 2019 15:40:08 +0000 (08:40 -0700)]
Remove extra DataDog link for ASWF

An extra DataDog link for ASWF was missed during review for
commit 117fdd6cfc5fb2c7d3707b5e94ea9a122c4db815

Change-Id: I7e40ff1e9dcbbf03d659ce4ae377782a7a147ce8
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoadd datadoge dashboard links for jenkins instances 69/16569/2
Daniel Pono Takamori [Thu, 15 Aug 2019 21:14:33 +0000 (14:14 -0700)]
add datadoge dashboard links for jenkins instances

Change-Id: I54203c9156f0ecc2297fc3131335fb7e7f410788
Signed-off-by: Daniel Pono Takamori <dtakamori@contractor.linuxfoundation.org>
5 years agoadd zowe to inventory 99/16499/1
Daniel Pono Takamori [Fri, 9 Aug 2019 00:53:05 +0000 (17:53 -0700)]
add zowe to inventory

Change-Id: I9a05c2963b66e5db598e80d89d51ea58b86f3c25
Signed-off-by: Daniel Pono Takamori <dtakamori@contractor.linuxfoundation.org>
5 years agoMerge "github workflow docs for community"
Daniel Pono Takamori [Thu, 8 Aug 2019 21:20:17 +0000 (21:20 +0000)]
Merge "github workflow docs for community"

5 years agogithub workflow docs for community 78/16178/6
Daniel Pono Takamori [Thu, 11 Jul 2019 19:11:56 +0000 (12:11 -0700)]
github workflow docs for community

Issue: RELENG-2189
Change-Id: I56ced09b1342af2f05a176367ecb944d126e6430
Signed-off-by: Daniel Pono Takamori <dtakamori@contractor.linuxfoundation.org>
5 years agoadd bootstrap doc for jenkins-sandbox-access group 68/16068/4
Daniel Pono Takamori [Wed, 3 Jul 2019 20:40:03 +0000 (13:40 -0700)]
add bootstrap doc for jenkins-sandbox-access group

Change-Id: I130a20cd6c9aae9a8d8dad6e97fdf3226b82acde
Signed-Off-By: Pono <dtakamori@contractor.linuxfoundation.org>
5 years agoAdd how to share issues information 39/16239/5
Andrew Grimberg [Wed, 17 Jul 2019 21:21:39 +0000 (14:21 -0700)]
Add how to share issues information

Update the docs to explain how we can share issues at present.

Issue: RELENG-2204
Change-Id: Ia58b0cd046b88b7db7278560a395a1b7f1f3e112
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoDo not use pip cache, fix coala warning 32/16332/2
Eric Ball [Fri, 26 Jul 2019 11:48:50 +0000 (04:48 -0700)]
Do not use pip cache, fix coala warning

Builds have been failing due to using some very old cached versions
of dependencies. By using --no-cache-dir, we force pip to pull in
up-to-date versions of all dependencies.
This also includes a change to language that caused tox to fail due
to a coala warning.

Issue: RELENG-2208
Change-Id: I4ad3256e2c3fe2d8a8b4c0878d0e0a3f54ccc722
Signed-off-by: Eric Ball <eball@linuxfoundation.org>
5 years agoMerge "Test global-jjb/lftools changes on Jenkins"
Anil Belur [Mon, 24 Jun 2019 22:22:27 +0000 (22:22 +0000)]
Merge "Test global-jjb/lftools changes on Jenkins"

5 years agoTest global-jjb/lftools changes on Jenkins 81/15881/5
Anil Belur [Wed, 19 Jun 2019 02:25:21 +0000 (12:25 +1000)]
Test global-jjb/lftools changes on Jenkins

Add docs on testing new change in global-jjb or lftools
on the master with the Jenkins Jobs. Doing this avoids
regressions and the time spent for hotfixes.

Change-Id: I7725be334eeae792b794e256f0064cc3d73b8aea
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
5 years agoChange helpdesk links to Helpdesk Docs 43/15943/2
Eric Ball [Wed, 19 Jun 2019 17:10:44 +0000 (10:10 -0700)]
Change helpdesk links to Helpdesk Docs

Change-Id: Ia3c2fe8f275bc29b228933059f4372d62ab2a122
Signed-off-by: Eric Ball <eball@linuxfoundation.org>
5 years agoMerge "where to find NETWORK-ID and install crudini from package manager"
Daniel Pono Takamori [Mon, 17 Jun 2019 20:19:54 +0000 (20:19 +0000)]
Merge "where to find NETWORK-ID and install crudini from package manager"

5 years agowhere to find NETWORK-ID and install crudini from package manager 13/15913/1
Daniel Pono Takamori [Mon, 17 Jun 2019 19:29:30 +0000 (12:29 -0700)]
where to find NETWORK-ID and install crudini from package manager

Change-Id: Ie009cd1513f8869fcb4c52aa775eefb762c7d091
Signed-off-by: Daniel Takamori <dtakamori@contractor.linuxfoundation.org>
5 years agoFix helpdesk docs typo 11/15911/1
Jessica Wagantall [Mon, 17 Jun 2019 18:52:55 +0000 (11:52 -0700)]
Fix helpdesk docs typo

Change-Id: I8ad7a19e763c555b050932690fe73f70154e0d19
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>
5 years agoRewrite helpdesk documentation 02/15902/2
Andrew Grimberg [Fri, 14 Jun 2019 20:45:41 +0000 (13:45 -0700)]
Rewrite helpdesk documentation

The switch from RT to Jira Service Desk requires that we publish some
new helpdesk docs.

Change-Id: Iccdb81cad078332e5abf7e1869f6e1a30bafed9b
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoAdd ODPi helpdesk info 56/15756/3
Andrew Grimberg [Fri, 24 May 2019 20:15:39 +0000 (13:15 -0700)]
Add ODPi helpdesk info

Change-Id: I7c8cbd0a7d362d0059dd8f4986e871b774ba5ed0
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoPin detox 59/15759/1
Andrew Grimberg [Fri, 24 May 2019 21:18:44 +0000 (14:18 -0700)]
Pin detox

detox 0.19 is not compatible with the version of tox we are getting from
upstream

Change-Id: Iaae2e180d66e58238fe13be219b2a02cfcfb4116
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoPin requests 58/15758/1
Andrew Grimberg [Fri, 24 May 2019 20:47:11 +0000 (13:47 -0700)]
Pin requests

Change-Id: Ide7c04cc94b8f9b1cc81ec0aa53bbe3836e9035a
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoMerge "Add documentation on using lftools for gerrit"
Andrew Grimberg [Fri, 24 May 2019 17:20:42 +0000 (17:20 +0000)]
Merge "Add documentation on using lftools for gerrit"

5 years agoAdd ORAN inventory 58/15658/1
Andrew Grimberg [Mon, 13 May 2019 21:21:43 +0000 (14:21 -0700)]
Add ORAN inventory

Change-Id: Icb6b2deea05f7b356f6c060b24664f07ab8a3249
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
5 years agoAdd documentation on using lftools for gerrit 43/15643/3
Aric Gardner [Mon, 13 May 2019 16:53:56 +0000 (12:53 -0400)]
Add documentation on using lftools for gerrit

Gerrit and github repo creation can now be done with lftools
same for enabling replication

Docs cover these new features.

Change-Id: I4a9528431512903f9efee2f3505f1b91bf5db1d9
Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
5 years agoIgnore 'https://iotivity.biterg.io' 45/15645/1
Aric Gardner [Mon, 13 May 2019 18:02:04 +0000 (14:02 -0400)]
Ignore 'https://iotivity.biterg.io'

This link is failing other builds

Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: Id61732497fe2ba80874ee11b40c33ec7f2170fc4

5 years agoPin pygments to 2.3.x 44/15644/1
Aric Gardner [Mon, 13 May 2019 17:06:43 +0000 (13:06 -0400)]
Pin pygments to 2.3.x

Pygments release 2.4.0 which added a python requires that excludes all
versions of Python < 3.5. The LFCI's default 3 version is 3.4 so causes
build failure.

Signed-off-by: Aric Gardner <agardner@linuxfoundation.org>
Change-Id: Ic67d0003d9ecba08f88f08db457e965dcf6725e5

5 years agoAdd LF Edge helpdesk handler 88/15488/1
Andrew Grimberg [Thu, 2 May 2019 19:29:05 +0000 (12:29 -0700)]
Add LF Edge helpdesk handler

The LF Edge project was apparently told that they have a
helpdesk@lfedge.org handler, but it was never properly established.
Since this has been communicated to the project that it exists (and
there was some mail routing in place) we need to have it documented.

Issue: IT-16332
Change-Id: I12a475be8ffedd4ccfb082bb592950b30b030401
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
6 years agoUpdate JJB calls to only do jobs 05/15405/1
Andrew Grimberg [Fri, 26 Apr 2019 15:27:51 +0000 (08:27 -0700)]
Update JJB calls to only do jobs

Our sandbox Jenkins systems do not allow non-admins the ability to
manage views. As such, the documentation should not give generic
commands that by default also push jobs.

Change-Id: I30d6a7f4d884b8f25516739cac5eb3e3a98f7055
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
6 years agoUpdate generic helpdesk email address 28/15328/2
Andrew Grimberg [Thu, 18 Apr 2019 17:27:27 +0000 (10:27 -0700)]
Update generic helpdesk email address

* helpdesk@rt.linuxfoundation.org no longer works as expected
* releng@rt.linuxfoundation.org was recently added to go directly to the
  RelEng queue in RT
* Fixed missing camel case for RelEng in doc

Issue: INFRA-4466
Change-Id: I3a17973b68996e194f19c58980b5fc73712d923e
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
6 years agoFix link doc links 29/15329/2
Andrew Grimberg [Thu, 18 Apr 2019 17:44:28 +0000 (10:44 -0700)]
Fix link doc links

Probot DCO:

GitHub looks to have changed the apps integration link from
https://github.com/integration/? to https://github.com/apps/? update the
DCO Probot link

Jenkins OWASP Markup plugin:

Upstream has moved the plugin from it's former URL to a shorter (and
cleaner) URL

Change-Id: I78c9a3ddaef07579702389a465d02b1bbb794998
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
6 years agoMerge "Update environment bootstrapping documents"
Anil Belur [Tue, 9 Apr 2019 20:26:23 +0000 (20:26 +0000)]
Merge "Update environment bootstrapping documents"

6 years agoUpdate environment bootstrapping documents 03/15203/4
Andrew Grimberg [Thu, 4 Apr 2019 20:38:52 +0000 (13:38 -0700)]
Update environment bootstrapping documents

With automatic cloud configuration now working well, the documents need
to be cleaned up to not have references to non-existent document
sections!

Additionally, fix tiny errors in the directions

Change-Id: I3e32ca782ad0e05dde5519c1da01112a12a347a2
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
6 years agoAdd Git usage workflow for a patch set. 19/13919/14
Bengt Thuree [Tue, 11 Dec 2018 04:42:23 +0000 (05:42 +0100)]
Add Git usage workflow for a patch set.

Add three patch set related workflows:

  * Breakdown a large patch into smaller patches.
  * Change a patch set.
  * Download an earlier version of patch set.

Issue: RELENG-1354
Change-Id: Ie56671f6095f5ff93c720aa7853bc657be97aa8d
Signed-off-by: Bengt Thuree <bthuree@linuxfoundation.org>
6 years agoIgnore broken Sandbox link 05/15205/4
Jessica Wagantall [Thu, 4 Apr 2019 22:10:35 +0000 (15:10 -0700)]
Ignore broken Sandbox link

Ignore broken link https://build.automotivelinux.org/sandbox
This is an old sandbox but we don't want to remove it from the
inventory list.

Change-Id: Iab36afe6961dc66e8ff2f5ec2a2a73a2fc7c9e4d
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>
6 years agoFix typo phased should be phase 79/15079/2
Thanh Ha [Wed, 27 Mar 2019 15:53:30 +0000 (11:53 -0400)]
Fix typo phased should be phase

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