Skip to content

V4#127

Merged
spbsoluble merged 10 commits intomainfrom
v4
Sep 11, 2025
Merged

V4#127
spbsoluble merged 10 commits intomainfrom
v4

Conversation

@spbsoluble
Copy link
Contributor

@spbsoluble spbsoluble commented Sep 9, 2025

Features

  • doctool screenshots via static SES environment

@spbsoluble spbsoluble requested a review from Copilot September 9, 2025 19:39
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR upgrades the GitHub Actions workflows from version 3 to version 4, introducing improved documentation generation capabilities and modernizing the workflow structure.

Key Changes:

  • Upgrade all workflow references from v3 to v4
  • Add new authentication parameters for Entra and Command API integration
  • Introduce doctool functionality for automated screenshot generation in Universal Orchestrator extensions
  • Remove legacy v3-specific templates and shared data files

Reviewed Changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated no comments.

Show a summary per file
File Description
readme-templates/readme_shared_data.json Removes legacy shared template data for v3 system
readme-templates/readme_platform_pam.md Removes v3 PAM provider template
readme-templates/readme_platform_orchestrator.md Removes v3 orchestrator platform template
readme-templates/readme_platform_cagateway.md Removes v3 CA gateway platform template
readme-templates/readme.md.tpl Removes v3 main README template
README.md Updates documentation from v3 to v4 with new features and usage examples
.github/workflows/starter.yml Updates to v4 workflows and adds new authentication parameters
.github/workflows/starter-v3.yml Creates new v3 compatibility workflow file
.github/workflows/github-release.yml Updates workflow reference to v4
.github/workflows/generate-readme.yml Adds new authentication parameters for doctool integration

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@spbsoluble spbsoluble requested review from doebrowsk and irby September 9, 2025 19:39
Copy link

@irby irby left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Everything looks good to me. Do want to check and make sure the case sensitivity and vars vs input isn't an issue.

entra_password: ${{ secrets.entra_password }}
command_client_id: ${{ secrets.command_client_id }}
command_client_secret: ${{ secrets.command_client_secret }}
command_token_url: ${{ vars.DOCTOOL_COMMAND_TOKEN_URL }}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just want to make sure, but this doesn't need to be inputs.command_token_url, etc., does it?

Copy link
Contributor Author

@spbsoluble spbsoluble Sep 11, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think I initially had used inputs. for all these params before and things weren't working, but the workflow is working as-is so I think this is fine

command_base_api_path: ${{ vars.COMMAND_API_PATH }}
secrets:
token: ${{ secrets.token }}
entra_username: ${{ secrets.ENTRA_USERNAME }}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Want to make sure Actions is not case sensitive, this doesn't need to be {{ secrets.entra_username }}?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The org secret name is all caps ENTRA_USERNAME I suspect I'm probably not using the inputs properly(/at all) but when I was using inputs. the value was empty.

uses: Keyfactor/actions/.github/workflows/generate-readme.yml@v3
uses: Keyfactor/actions/.github/workflows/generate-readme.yml@v4
with:
command_token_url: ${{ vars.COMMAND_TOKEN_URL }}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shouldn't this be ${{ inputs.command_token_url }}? I think this is also case sensitive.

@spbsoluble spbsoluble merged commit 1386fab into main Sep 11, 2025
1 check passed
@doebrowsk
Copy link
Contributor

🎉 This PR is included in version 3.4.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

@doebrowsk
Copy link
Contributor

🎉 This PR is included in version 3.4.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants