releng/docs.git
6 weeks agoChore: Update Anuket inventory 29/73429/1
Andrew Grimberg [Wed, 12 Mar 2025 17:14:26 +0000 (10:14 -0700)]
Chore: Update Anuket inventory

Update sorting for Anuket as well as remove the Jenkins links as they
are broken and no longer in use. Add in the GitLab links for Anuket.

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

4 months agoChore: Update pre-commit hooks and docs 50/73350/3
Andrew Grimberg [Thu, 5 Dec 2024 16:43:58 +0000 (08:43 -0800)]
Chore: Update pre-commit hooks and docs

pre-commit updates:

github.com/pre-commit/pre-commit-hooks: v4.6.0 -> v5.0.0 (frozen)
github.com/astral-sh/ruff-pre-commit: v0.4.7 -> v0.8.2 (frozen)
github.com/pycqa/bandit: v1.7.8 -> 1.8.0 (frozen)
github.com/rhysd/actionlint: v1.7.1 -> v1.7.4 (frozen)
github.com/fsfe/reuse-tool: v3.0.2 -> v5.0.2 (frozen)

Docs updates:
Datadog monitoring links are no longer available and must be removed.
As we need to also update the pre-commit at the same time both changes
are being included in this commit.

Remove ASWF Jira as they have not used or had one for a long time

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

6 months agoDocs: Add LF Broadband to inventory page 50/73250/2
Eric Ball [Tue, 22 Oct 2024 22:02:48 +0000 (15:02 -0700)]
Docs: Add LF Broadband to inventory page

Change-Id: I9eb775702d9d038be19f62a72942565c33f43637
Issue-ID: RELENG-5599
Signed-off-by: Eric Ball <eball@linuxfoundation.org>
6 months agoDocs: Clean up broken links 51/73251/1
Eric Ball [Tue, 22 Oct 2024 23:12:23 +0000 (16:12 -0700)]
Docs: Clean up broken links

Tungsten fabric can be removed entirely. Nexus 2 docs are no longer
online, but can be downloaded as a PDF.

Change-Id: I6c3a66f16c228471f8b6995f211f7aaec458b2ab
Issue-ID: RELENG-5599
Signed-off-by: Eric Ball <eball@linuxfoundation.org>
8 months agoCI: Add github2gerrit workflow 26/73126/3
Anil Belur [Thu, 8 Aug 2024 02:14:24 +0000 (12:14 +1000)]
CI: Add github2gerrit workflow

Configure the github2gerrit workflow to allow PRs to open Gerrit changes
against the LFIT Gerrit system.

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

8 months agoFix: Update ASWF Jira to Atlassian cloud instance 36/73136/1
Anil Belur [Thu, 15 Aug 2024 02:50:38 +0000 (12:50 +1000)]
Fix: Update ASWF Jira to Atlassian cloud instance

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

10 months agoCI: Add reuse for license checking 36/72936/1
Andrew Grimberg [Wed, 5 Jun 2024 19:03:07 +0000 (12:03 -0700)]
CI: Add reuse for license checking

* Enable the reuse license checker
* Add in needed SPDX headers to pass the validation

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

10 months agoChore: Update pre-commit hooks 21/72921/1
Andrew Grimberg [Tue, 4 Jun 2024 13:37:19 +0000 (06:37 -0700)]
Chore: Update pre-commit hooks

* github.com/pre-commit/pre-commit-hooks: v4.4.0 -> v4.6.0 (frozen)
* github.com/jorisroovers/gitlint: v0.18.0 -> v0.19.1 (frozen)
* github.com/astral-sh/ruff-pre-commit: v0.4.5 -> v0.4.7 (frozen)
* github.com/pycqa/bandit: 1.7.5 -> 1.7.8 (frozen)
* github.com/pycqa/pydocstyle: 6.3.0 -> 6.3.0 (frozen)
* github.com/btford/write-good: v1.0.8 -> v1.0.8 (frozen)
* github.com/rhysd/actionlint: v1.6.26 -> v1.7.1 (frozen)

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

10 months agoCI: Swap in ruff for black and flake8 20/72920/1
Andrew Grimberg [Tue, 4 Jun 2024 13:35:21 +0000 (06:35 -0700)]
CI: Swap in ruff for black and flake8

* ruff runs significantly faster than black and flake8 and is a single
  tool instead of two separate tools
* Fix the bandit configuration to properly exclude all test files

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

10 months agoCI: Update actions to latest versions 16/72916/1
Andrew Grimberg [Mon, 3 Jun 2024 19:35:17 +0000 (12:35 -0700)]
CI: Update actions to latest versions

* Add actionlint to pre-commit
* Use LF Release Engeinering lint reusable workflow

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

10 months agoCI: Switch workflow conclusion getter 14/72914/1
Andrew Grimberg [Mon, 3 Jun 2024 17:21:43 +0000 (10:21 -0700)]
CI: Switch workflow conclusion getter

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

11 months agoChore: Update Project Inventory 44/72844/8
Vanessa Valderrama [Thu, 2 May 2024 17:04:58 +0000 (12:04 -0500)]
Chore: Update Project Inventory

 - Removing LF Edge Jenkins and adding GHA
 - Removing Hyperledger Azure to resolve tox errors. I confirmed with
Ry that Hyperledge is no longer using Azure
 - Removing Hyperledger Jira, which was shut down in January 2024
 - Removing all Insights links now that projects need to request
access
 - Update links for Nexus 2 and 3, and their format has changed

Issue: RELENG-5106
Change-Id: I12e34f902e8f0d9e204611a4fa7d352e3511cdc2
Signed-off-by: Vanessa Valderrama <vvalderrama@linuxfoundation.org>
Signed-off-by: Eric Ball <eball@linuxfoundation.org>
16 months agoCI: Update RTD configuration file 19/72419/3
Andrew Grimberg [Wed, 29 Nov 2023 13:59:59 +0000 (05:59 -0800)]
CI: Update RTD configuration file

RTD has finished their switch to requiring version 2 of their
configuration file and we must now update to work with it.

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

16 months agoDocs: Update Tungsten Fabric inventory 21/72421/2
Andrew Grimberg [Wed, 29 Nov 2023 16:29:55 +0000 (08:29 -0800)]
Docs: Update Tungsten Fabric inventory

* Link to GitHub archive
* Remove docs site as it is defunct

* Change gitlint version down to a version that works with current GHA
  enviroment

Change-Id: I7c79d39aaaee0b54e31af0c96787edd8997ff1ed
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
18 months agoChore: Update infra inventory 97/72197/2
Vanessa Valderrama [Mon, 2 Oct 2023 17:44:23 +0000 (12:44 -0500)]
Chore: Update infra inventory

Removing TF services that have been decommissioned as part of the
vote to archive the project.

Modifying the Anuket Jenkins URLs to point to the new instances.

Change-Id: I94129a2c02fe82fae109180ed25307b9cd0a783f
Signed-off-by: Vanessa Valderrama <vvalderrama@linuxfoundation.org>
2 years agoCI: Use v0.3 of gerrit-review-action 25/71525/1
Andrew Grimberg [Mon, 10 Apr 2023 18:04:51 +0000 (11:04 -0700)]
CI: Use v0.3 of gerrit-review-action

* Add a 10s sleep in the prepare to allow replication to catch up

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

2 years agoCI: Update pre-commit hooks 02/71502/2
Andrew Grimberg [Tue, 4 Apr 2023 22:38:52 +0000 (15:38 -0700)]
CI: Update pre-commit hooks

* github.com/pre-commit/pre-commit-hooks: v4.2.0 -> v4.4.0
* github.com/jorisroovers/gitlint: v0.17.0 -> v0.19.1
* github.com/ambv/black: 22.3.0 -> 23.3.0
* github.com/PyCQA/flake8: 3.9.2 -> 6.0.0
* github.com/pycqa/bandit: 1.7.4 -> 1.7.5
* github.com/pycqa/pydocstyle: 6.1.1 -> 6.3.0

Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
Change-Id: If13a39f3541ca1d253b2426c513d1d782bffe716
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
2 years agoFix: Correct badly stated needs statement 03/71503/1
Andrew Grimberg [Tue, 4 Apr 2023 22:50:21 +0000 (15:50 -0700)]
Fix: Correct badly stated needs statement

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

2 years agoCI: Add GHA verification 00/71500/2
Andrew Grimberg [Tue, 4 Apr 2023 18:44:09 +0000 (11:44 -0700)]
CI: Add GHA verification

Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
Change-Id: I8bc75dffa138b9720303237f9f3d0e96f1aea534
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
2 years agoDocs(g2p): Point gerrit-to-platform to stable docs 97/71497/2
Andrew Grimberg [Tue, 4 Apr 2023 16:58:25 +0000 (09:58 -0700)]
Docs(g2p): Point gerrit-to-platform to stable docs

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

2 years agoDocs(dent): Remove DENT section 98/71498/1
Andrew Grimberg [Tue, 4 Apr 2023 17:21:59 +0000 (10:21 -0700)]
Docs(dent): Remove DENT section

LF Release Engineering no longer services DENT. Additionally, services
we had running are no longer available and failing linkcheck

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

2 years agoFeat: Link gerrit-to-platform into docs 85/71485/2
Andrew Grimberg [Thu, 30 Mar 2023 17:47:38 +0000 (10:47 -0700)]
Feat: Link gerrit-to-platform into docs

Issue: RELENG-4564
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
Change-Id: I8ddcd830217bde11419af60972059a3564d3cf84
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
2 years agoFix: Update repo creation documentation 53/71353/4
Jessica Wagantall [Wed, 8 Mar 2023 20:06:58 +0000 (12:06 -0800)]
Fix: Update repo creation documentation

Update docs on porject creation instructions to reflect
what happens with any project configuration files and
credentials.

Issue: RELENG-4616
Change-Id: I693cde08c5efa3c047a34b1a4e633b776ab7b202
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>
2 years agoChore: Update TF Inventory 63/71163/5
Vanessa Valderrama [Wed, 18 Jan 2023 18:48:25 +0000 (12:48 -0600)]
Chore: Update TF Inventory

Update the inventory page to remove the decomissioned instances.

- Jenkins instances are being decommissioned
- Update logs to S3 for fd.io
- Flake8 gitlab repo has been removed in favor of github

Issue-ID: RELENG-4560
Signed-off-by: Vanessa Valderrama <vvalderrama@linuxfoundation.org>
Change-Id: I71fb87e0b152e81a4637f974a0eeeb99dafa7252
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
2 years agoChore: Update FD.io inventory 31/70231/4
Vanessa Valderrama [Thu, 2 Jun 2022 18:27:31 +0000 (13:27 -0500)]
Chore: Update FD.io inventory

Removing Nexus which has been decommissioned
Adding PackageCloud

Issue: RELENG-4259
Signed-off-by: Vanessa Valderrama <vvalderrama@linuxfoundation.org>
Change-Id: I608a505d40151e289378fa5a49421c86ea4ca4b8

2 years agoDocs: fix enumeration and indentation 98/70598/2
Kevin Sandi [Wed, 7 Sep 2022 23:30:34 +0000 (17:30 -0600)]
Docs: fix enumeration and indentation

Signed-off-by: Kevin Sandi <ksandi@contractor.linuxfoundation.org>
Change-Id: Iab7ca1d3dc61dfd07467008ce77c3f6ba5f4f53b

2 years agoChore: Fix tox verify 47/70347/6
Anil Belur [Fri, 1 Jul 2022 04:04:16 +0000 (14:04 +1000)]
Chore: Fix tox verify

- Rm all acumos resources on the infra is decomissioned.
- Rm Nexus fd.io is decommissioned.
- Update pre-commit deps
  gitlint v4.0.1 -> v4.3.0.
  black v0.15.1 -> v0.17.0.
  flake8 updating 21.9b0 -> 22.6.0.
  bandit 1.7.0 -> 1.7.4.
  write-good v1.0.4 -> v1.0.8.
- Reword docs to address write-good warnings
- Set default language to 'en'

Fixes the following Sphinx warning (treated as error) starting
with 5.0 release:

Warning, treated as error: Invalid configuration value found:
'language = None'. Update your configuration to a valid langauge
code. Falling back to 'en' (English).

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

3 years agoChore: Modify Anuket Dashboard Link 57/69957/1
Vanessa Valderrama [Tue, 5 Apr 2022 15:59:40 +0000 (10:59 -0500)]
Chore: Modify Anuket Dashboard Link

Modifying the Anuket Datadog dashboard link to the
functioning dashbaord.

Issue: RELENG-4186
Signed-off-by: Vanessa Valderrama <vvalderrama@linuxfoundation.org>
Change-Id: Idfc3c06271a0fd43a0455c3e0d8f8853536f9c98

3 years agoDocs: Gerrit must generate HTTP credentials 44/69944/1
Andrew Grimberg [Fri, 1 Apr 2022 15:25:03 +0000 (08:25 -0700)]
Docs: Gerrit must generate HTTP credentials

Since switching to Auth0 / SAML logins in 2021 on all Gerrit systems, we
no longer support LFID passwords for HTTP credentials and Gerrit must
generate the password.

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

3 years agoChore: Add pipelines to Tools list in index 43/69843/1
Eric Ball [Wed, 9 Mar 2022 23:52:30 +0000 (15:52 -0800)]
Chore: Add pipelines to Tools list in index

Issue: RELENG-4151
Change-Id: I3d83cd379a8e2299951b7647df4fcf17e594b989
Signed-off-by: Eric Ball <eball@linuxfoundation.org>
3 years agoChore: Update INFO schema related docs 41/69741/1
Jessica Wagantall [Thu, 24 Feb 2022 23:03:40 +0000 (15:03 -0800)]
Chore: Update INFO schema related docs

Update commands to Verify against INFO.yaml schema

Issue: IT-23633
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>
Change-Id: If4ceb8c030192d8c3d3aa63b22182d3033b2e1b5

3 years agoChore: Update inventory page for all projects 22/69722/3
Vanessa Valderrama [Tue, 22 Feb 2022 19:33:27 +0000 (13:33 -0600)]
Chore: Update inventory page for all projects

Updating the Datadog dashboard links for all projects
Collapsing categories so the page is easier to view

Issue: RELENG-4113
Signed-off-by: Vanessa Valderrama <vvalderrama@linuxfoundation.org>
Change-Id: I076b67bb5549d3fa25d7457b563695bc44ec6665

3 years agoChore: Update inventory page for all projects 28/69528/9
Vanessa Valderrama [Tue, 18 Jan 2022 16:56:39 +0000 (10:56 -0600)]
Chore: Update inventory page for all projects

Updating the inventory page for all projects removing obsolete
inventory and adding new inventory

Issue: RELENG-4084
Signed-off-by: Vanessa Valderrama <vvalderrama@linuxfoundation.org>
Change-Id: Ib1212da4c5e4152abf31a12f6369788f5b0a6995

3 years agoDocs: Update ASWF links 51/69351/1
Andrew Grimberg [Wed, 8 Dec 2021 17:57:56 +0000 (09:57 -0800)]
Docs: Update ASWF links

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

3 years agoDocs: Add statement about meta-data handling 77/69177/3
Andrew Grimberg [Wed, 24 Nov 2021 16:22:00 +0000 (08:22 -0800)]
Docs: Add statement about meta-data handling

Several contributors have been unclear on guidance around meta-data
handling in commit messages. Instead of expecting folks to grok it from
linked documentation and examples, it's better to be explicit.

Change-Id: Ia0411eb9e1b54c4d1ff3863bd428124809856329
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>
3 years agoChore: Add more info on subprojects 58/69058/5
Jessica Wagantall [Mon, 1 Nov 2021 19:05:46 +0000 (12:05 -0700)]
Chore: Add more info on subprojects

Add more details on how to set up subprojects

Issue: IT-23187
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>
Change-Id: I59c940486c1b00956724862bcbb1cf8e541710e0

3 years agoFix: Add additional remarks in docs 53/69053/4
Jessica Wagantall [Fri, 29 Oct 2021 19:32:50 +0000 (12:32 -0700)]
Fix: Add additional remarks in docs

Add additional instructions for newly created
projects.

Issue: IT-23187
Signed-off-by: Jessica Wagantall <jwagantall@linuxfoundation.org>
Change-Id: Ibd23cb33dccc8065b3b09085c8e06a89f2b6647c

3 years agoDocs: Remove Zowe Jenkins instances 89/68789/3
Anil Belur [Tue, 14 Sep 2021 11:11:51 +0000 (21:11 +1000)]
Docs: Remove Zowe Jenkins instances

Zowe Jenkins instances are decommissioned.
Update pre-commit update: black 21.9b0

Error:
[ERROR] The hook `black` requires pre-commit version 2.9.2 but
version 2.8.2 is installed.  Perhaps run
`pip install --upgrade pre-commit`.

Issue-ID: RELENG-3940
Change-Id: Ic186450f4a52d6c2be703796047d7d7aac3cb4b6
Signed-off-by: Anil Belur <abelur@linuxfoundation.org>
3 years agoChore: Upgrade pre-commit hooks 80/68680/4
Andrew Grimberg [Wed, 1 Sep 2021 18:12:37 +0000 (11:12 -0700)]
Chore: Upgrade pre-commit hooks

* github.com/pre-commit/pre-commit-hooks: updating v3.4.0 -> v4.0.1
* github.com/ambv/black: updating 21.5b0 -> 21.8b0
* gitlab.com/pycqa/flake8: updating 3.9.1 -> 3.9.2
* github.com/pycqa/pydocstyle: updating 6.0.0 -> 6.1.1

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

3 years agoDocs: Fix OWASP Plugin URL 14/68714/1
Andrew Grimberg [Fri, 3 Sep 2021 19:16:41 +0000 (12:16 -0700)]
Docs: Fix OWASP Plugin URL

wiki.jenkins-ci.org no longer responds (and from looking around appears
to have been deprecated anyway). Replace old URL with current one

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

3 years agoFix: Dent Jira is decommissioned 84/68684/1
Anil Belur [Thu, 2 Sep 2021 03:14:09 +0000 (13:14 +1000)]
Fix: Dent Jira is decommissioned

This fails the linkcheck for the verify job.

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

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>