Skip to content
New issue

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

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

Already on GitHub? Sign in to your account

Update pump 1.12.md #6006

Open
wants to merge 10 commits into
base: master
Choose a base branch
from
Open

Update pump 1.12.md #6006

wants to merge 10 commits into from

Conversation

JoanCamosTyk
Copy link
Contributor

@JoanCamosTyk JoanCamosTyk commented Feb 19, 2025

User description

For internal users - Please add a Jira DX PR ticket to the subject!



Preview Link


Description


Screenshots (if appropriate)


Checklist

  • I have added a preview link to the PR description.
  • I have reviewed the suggestions made by our AI (PR Agent) and updated them accordingly (spelling errors, rephrasing, etc.)
  • I have reviewed the guidelines for contributing to this repository.
  • I have read the technical guidelines for contributing to this repository.
  • Make sure you have started your change off our latest master.
  • For Tyk Members - Please add a Jira DX PR ticket to the subject!
  • For Tyk Members - I have added the appropriate release label to this PR:
    • If it is for a future release, label it as future-release and specify the version (e.g., future-release, 6.0).
    • If it should be merged into an older version, use the specific version label (e.g., 4.1, 5.1).
    • If no label is added, it will be assumed that the PR should be merged into the latest current version (e.g., 5.5) and master.

PR Type

  • Documentation

Description

  • Added Pump v1.12 release notes section.

  • Included API key obfuscation details.

  • Noted breaking change: removal of SQLite.

  • Updated dependencies, upgrade instructions, and changelog.


Changes walkthrough 📝

Relevant files
Documentation
pump.md
Add Pump v1.12 release notes details                                         

tyk-docs/content/developer-support/release-notes/pump.md

  • Inserted new section for release v1.12.
  • Documented release date and highlights.
  • Added breaking changes and dependency notes.
  • Provided upgrade instructions and detailed changelog.
  • +92/-0   

    Need help?
  • Type /help how to ... in the comments thread for any questions about PR-Agent usage.
  • Check out the documentation for more information.
  • @JoanCamosTyk JoanCamosTyk changed the title Update pump 1.12 .md Update pump 1.12.md Feb 19, 2025
    Copy link
    Contributor

    github-actions bot commented Feb 19, 2025

    PR Reviewer Guide 🔍

    (Review updated until commit 6be287f)

    Here are some key observations to aid the review process:

    ⏱️ Estimated effort to review: 1 🔵⚪⚪⚪⚪
    🧪 No relevant tests
    🔒 No security concerns identified
    ⚡ Recommended focus areas for review

    Version Formatting

    The release notes refer to "PostgreSQL 1.17" which appears inconsistent with the table listing "13.x - 17.x". Please verify and update the version formatting for clarity.

    <summary>Support for PostgreSQL 1.17</summary>
    
    Pump now supports PostgreSQL 1.17, ensuring compatibility with the latest database version.
    
    </details>
    Incomplete CVE Detail

    The "Fixed the following CVE" section does not specify any CVE identifier or details. Including this information would improve traceability and clarity in the release notes.

    <details>
    <summary>Fixed the following CVE</summary>
    
    
    
    </details>

    Copy link
    Contributor

    github-actions bot commented Feb 19, 2025

    PR Code Suggestions ✨

    Latest suggestions up to 6be287f
    Explore these optional code suggestions:

    CategorySuggestion                                                                                                                                    Impact
    Possible issue
    Complete CVE information

    Provide the actual CVE details or remove the empty placeholder to avoid confusion.

    tyk-docs/content/developer-support/release-notes/pump.md [104-109]

     <details>
    -<summary>Fixed the following CVE</summary>
    -
    -
    +<summary>Fixed CVE-XXXXX</summary>
    +Detailed description of the fix.
     </details>
    Suggestion importance[1-10]: 5

    __

    Why: The suggestion addresses the incomplete security fix information by proposing to include specific CVE details or removing the placeholder. This enhances clarity and utility for the end user, even though the improved text still contains a placeholder that would require further refinement.

    Low
    Correct PostgreSQL version labeling

    Correct the PostgreSQL version reference to match the supported version range.

    tyk-docs/content/developer-support/release-notes/pump.md [83-85]

    -<summary>Support for PostgreSQL 1.17</summary>
    -Pump now supports PostgreSQL 1.17, ensuring compatibility with the latest database version.
    +<summary>Support for PostgreSQL 17</summary>
    +Pump now supports PostgreSQL 17, ensuring compatibility with the latest database version.
    Suggestion importance[1-10]: 4

    __

    Why: The suggestion targets a minor textual change by altering the PostgreSQL version from "1.17" to "17", which might improve clarity if the intended version is indeed "17". However, the necessity of this change is debatable given that the original might have been intentional.

    Low

    Previous suggestions

    Suggestions up to commit 0d9fd5c
    CategorySuggestion                                                                                                                                    Impact
    General
    Fill in the changelog section details

    Add details under the "Changelog" section to provide a comprehensive list of
    changes, fixes, or improvements made in version 1.12.

    tyk-docs/content/developer-support/release-notes/pump.md [61]

     #### Changelog {#Changelog-v1.12.0}
    +- Updated dependency compatibility for PostgreSQL, MongoDB, and Redis.
    +- Enhanced performance for Tyk Pump data processing.
    +- Fixed minor bugs reported in version 1.11.0.
    Suggestion importance[1-10]: 9

    __

    Why: Adding detailed changelog information is critical for transparency and helps users understand the specific changes, fixes, and improvements in the release. This significantly enhances the utility of the release notes.

    High
    Populate the release highlights section

    Add content under the "Release Highlights" section to summarize the key features or
    improvements introduced in version 1.12 for better readability.

    tyk-docs/content/developer-support/release-notes/pump.md [27]

     #### Release Highlights
    +- Improved compatibility with PostgreSQL versions 13.x to 17.x.
    +- Updated tested versions for MongoDB and Redis dependencies.
    Suggestion importance[1-10]: 8

    __

    Why: Including key features or improvements in the "Release Highlights" section enhances the readability and usefulness of the release notes, providing users with a quick overview of the changes.

    Medium
    Add missing release date information

    Specify the release date for version 1.12 in the "Release Date xxxx" section to
    provide clarity and completeness to the release notes.

    tyk-docs/content/developer-support/release-notes/pump.md [25]

    -#### Release Date xxxx
    +#### Release Date February 19, 2025
    Suggestion importance[1-10]: 7

    __

    Why: Adding the release date improves the completeness and clarity of the release notes, which is important for users referencing the document. However, the exact date should be verified before implementation.

    Medium

    Copy link

    netlify bot commented Feb 19, 2025

    PS. Pls add /docs/nightly to the end of url

    Name Link
    🔨 Latest commit 70658ac
    🔍 Latest deploy log https://app.netlify.com/sites/tyk-docs/deploys/67d14e6e0ef3a6000803d5b3
    😎 Deploy Preview https://deploy-preview-6006--tyk-docs.netlify.app
    📱 Preview on mobile
    Toggle QR Code...

    QR Code

    Use your smartphone camera to open QR code link.

    To edit notification comments on pull requests, go to your Netlify site configuration.

    @sharadregoti sharadregoti marked this pull request as draft February 20, 2025 09:15
    Comment on lines +101 to +111
    ##### Security Fixes
    <ul>
    <li>
    <details>
    <summary>Fixed the following CVE</summary>



    </details>
    </li>
    </ul>
    Copy link
    Contributor

    Choose a reason for hiding this comment

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

    Remove this if not required.

    Comment on lines 72 to 79
    <li>
    <details>
    <summary>Prometheus Pump API Key Obfuscation</summary>

    Previously, API keys were exposed in the /metrics endpoint, posing a potential security risk. With this update, API keys can now be obfuscated, preventing unintended exposure while maintaining full monitoring capabilities.

    </details>
    </li>
    Copy link
    Contributor

    Choose a reason for hiding this comment

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

    @alienor I think we should remove this point. Can you confirm?

    Copy link

    @alienor alienor Mar 11, 2025

    Choose a reason for hiding this comment

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

    Agree, this shouldn't be for the public release notes, mentioning potential security risks in previous versions puts our customers at risk. This is also mentioned as the release highlights at the top. Can something else be used for the highlights?
    Please refer here for guidance: https://tyktech.atlassian.net/wiki/spaces/securitycop/pages/2807857178/Public+Release+Notes

    Copy link
    Contributor

    Persistent review updated to latest commit 6be287f


    <li>
    <details>
    <summary>Support for PostgreSQL 1.17</summary>
    Copy link
    Contributor

    Choose a reason for hiding this comment

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

    should be PostgreSQL 17 (not 1.17)

    <details>
    <summary>Support for PostgreSQL 1.17</summary>

    Pump now supports PostgreSQL 1.17, ensuring compatibility with the latest database version.
    Copy link
    Contributor

    Choose a reason for hiding this comment

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

    same as above

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

    Successfully merging this pull request may close these issues.

    4 participants