Skip to content
New issue

Have a question about this project? # for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “#”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? # to your account

[Feature Request]: Include module readme updates to pipeline trigger paths #1648

Open
eriqua opened this issue Jul 7, 2022 · 7 comments
Open
Assignees
Labels
blocked if an issue is blocked [cat] pipelines category: pipelines [cat] testing category: testing enhancement New feature or request

Comments

@eriqua
Copy link
Contributor

eriqua commented Jul 7, 2022

Description

Due to the recently added test which verifies module readmes are compliant with the Set-ModuleReadme script, changes to the readme files should trigger the corresponding module pipelines.
In fact, changes to readme files could invalidate the test, causing the static validation step and thus the pipeline to fail.

  • Update pipeline trigger paths to include module readme.
  • .md files other than the module readmes should still be excluded.
@eriqua eriqua added enhancement New feature or request [cat] pipelines category: pipelines [cat] testing category: testing labels Jul 7, 2022
@AlexanderSehr
Copy link
Contributor

AlexanderSehr commented Jul 14, 2022

Not sure about this. We have the test to make sure our ReadMe's are up to date, but it won't help anybody to publish a new module version just because the readMe was updated - nor run the deployment tests.

I know where you're coming from and hence wonder if there is a way to fail GitHub pipelines on 2 levels like in Azure DevOps: Warning vs. Failed.

@AlexanderSehr
Copy link
Contributor

AlexanderSehr commented Jul 21, 2022

Discussion: The test makes sense, however - we should make sure no new version is published just because a readme was changed. To that end, we should doublecheck if the Publishing (& deployment?) Logic actually excludes ReadMe files (and other non-module files, like test files) - and further update the pipeline triggers to test also ReadMe changes

@rahalan
Copy link
Contributor

rahalan commented Sep 27, 2022

@MariusStorhaug , can you please have a look at the above question (publishing)?

@MariusStorhaug
Copy link
Contributor

Publishing will say there is something to publish if there has been a change on a given module folder. It uses Git to find modifications or additions, finds relative folder path, finds bicep or json file, does the same for parents, then pushes those to an array with info on what to run publishing on. Talked with Erica on adding a filter to it, but thinking also that we are having some automation to cater for manual updates of the readme. How about we automate the updating when there is a PR? Creating a separate issue to discuss that topic.

@eriqua eriqua added the blocked if an issue is blocked label Sep 27, 2022
@eriqua
Copy link
Contributor Author

eriqua commented Sep 27, 2022

Moving the issue to blocked, since changes to the readme file will cause a new version of the module to be published and we agreed to not add the new trigger to the pipelines until when that won't be the case anymore.

@eriqua
Copy link
Contributor Author

eriqua commented Sep 15, 2023

@AlexanderSehr @ahmadabdalla @rahalan this and dependent issue need to be part of the AVM CI.

Changes to readme files should trigger corresponding module validation pipeline run, or at least static validation.

Changes to the set-module readme utility and its helper functions should trigger all module pipelines.
Alternatively, we could move them from the tools to the pipeline utility folder.

E.g., PR #3980 solved several pipeline failures, but didn't trigger the pipelines, which will stay red (and thus possibly their latest version not published) until manual run or next module template/test change.

If not for CARML, we need that to be the case for AVM.

@AlexanderSehr
Copy link
Contributor

@AlexanderSehr @ahmadabdalla @rahalan this and dependent issue need to be part of the AVM CI.

Changes to readme files should trigger corresponding module validation pipeline run, or at least static validation.

Changes to the set-module readme utility and its helper functions should trigger all module pipelines. Alternatively, we could move them from the tools to the pipeline utility folder.

E.g., PR #3980 solved several pipeline failures, but didn't trigger the pipelines, which will stay red (and thus possibly their latest version not published) until manual run or next module template/test change.

If not for CARML, we need that to be the case for AVM.

Agree. And yes to the "trigger static validation". Let's see if we can make it happen. In AVM we have to be a lot more deliberate on new published versions.

@AlexanderSehr AlexanderSehr added this to the Azure Verfified Modules (AVM) - CI Issues milestone May 19, 2024
@AlexanderSehr AlexanderSehr removed this from the Azure Verfified Modules (AVM) - CI Issues milestone Jul 1, 2024
# for free to join this conversation on GitHub. Already have an account? # to comment
Labels
blocked if an issue is blocked [cat] pipelines category: pipelines [cat] testing category: testing enhancement New feature or request
Projects
Status: Blocked
Development

No branches or pull requests

4 participants