Releases: Ed-Fi-Alliance-OSS/Ed-Fi-API-Publisher
v1.3.1-alpha.0.1
Pre-Release-v1.3.1-alpha.0.1 * Fix error where the ChangeProcessor.GetKeyChangeDependencies method…
v1.3.0
Ed-Fi API Publisher Release Notes - Version 1.3.0
Overview
Version 1.3.0 of the Ed-Fi API Publisher includes significant functional improvements, bug fixes, and engineering enhancements focused on reliability, security, and developer experience.
Summary of Functional Updates
- Bug Fixes: Fixed timeout issues with full min-max change version total count requests
- Bug Fixes: Fixed issue where API Publisher wouldn't publish when only 1 change was made
- Bug Fixes: Fixed exceptions being hidden when using remediation scripts
- New Feature: Added
authUrl
argument for authentication URL configuration - New Feature: Added namespace support for change version tracking via
lastChangeVersionProcessedNamespace
option - Improvements: Enhanced dependencies URL extraction from API metadata with fallback support
- Improvements: Enhanced logging context for different message producers
- Security: Updated Docker base images and dependencies to address vulnerabilities
- Documentation: Fixed documentation links and improved reverse paging documentation
Summary of Engineering Updates
Repository Infrastructure Enhancements
- Dependency Management: Added automated dependency updates through GitHub Dependabot configuration
- Project Organization: Enhanced project structure with improved build scripts and configuration files
- Documentation: Added comprehensive documentation covering:
- API connection management
- Configuration options
- Docker deployment considerations
- Extensibility patterns
- Known issues and remediation strategies
- Security: Implemented security best practices including:
- CODEOWNERS file for repository governance
- Issue templates for structured reporting
- Security policy documentation
- Build System: Improved build automation with PowerShell scripts supporting multiple deployment targets
Developer Experience Improvements
- Editor Configuration: Added consistent code formatting rules via
.editorconfig
- Issue Templates: Structured issue reporting with dedicated templates for engineering issues
- Copilot Integration: Added GitHub Copilot instructions for enhanced development assistance
- Docker Support: Enhanced Docker configuration with compose files and deployment templates
Changes in This Release
Commit | Author | Pull Request | Description |
---|---|---|---|
9d2542b | Stephen Fuqua | #99 | Create dependabot.yml - Added comprehensive repository infrastructure including CI/CD workflows, documentation, security policies, and automated dependency management |
25c2d29 | jagudelo-gap | #97 | Issue Management Template and Action Workflow - Added issue templates, updated workflow configurations, and detailed Copilot instructions |
4cd13d0 | dfernandez-gap | #96 | Changes in OnRelease Workflow to Delete Previous PreRelease Tags as well as GH Releases |
3d264f9 | jleiva-gap | #95 | Update openssl version for dockerfiles - Updated to version 3.3 |
a84e1ed | jagudelo-gap | #94 | Fix the Step "Create API Publisher Pre-Release" |
98c6f80 | DavidJGapCR | #93 | Fixes documentation link on reverse paging |
f30ef4e | brian-pazos | #92 | Add authUrl argument and dependencies URL from metadata - Refactored to add authUrl argument and extract dependencies URL from metadata |
9b0fcfd | jpardogrowthaccelerationpartners | #91 | Update the deprecated packages |
431baf7 | DavidJGapCR | #90 | API Publisher some exceptions are hidden when using a remediation script |
da17bee | ea-mtenhoor | #89 | API Publisher some exceptions are hidden when using a remediation script |
7e34787 | ea-mtenhoor | #88 | Log correct context - Fixed issue where all MessageProducers were logging in the same context |
4be38b6 | ea-mtenhoor | #87 | Fix total count timeout and publishing with only 1 change - Fixed timeout issues and single change publishing problems |
c0a5461 | ea-mtenhoor | #86 | Add namespace to change version tracking - Added lastChangeVersionProcessedNamespace option for additional uniqueness |
74814f5 | jasonh-edfi | #85 | Update Reverse-Paging.md |
f742485 | jleiva-gap | #84 | Fixing vulnerabilities found with Docker Scout - Updated packages and Alpine version |
ca01994 | DavidJGapCR | #83 | Adds Sonar Analyzer - Log as json where appropriate |
50559ff | DavidJGapCR | #82 | Adds Sonar Analyzer - log web api metadata as a json format |
c4cbd7c | DavidJGapCR | #81 | Fixing Actions |
fa51c2c | DavidJGapCR | #80 | Adds Sonar Analyzer |
Compatibility
This release maintains backward compatibility with version 1.2.1. While new features and bug fixes have been added, no breaking changes have been introduced. The new authUrl
and lastChangeVersionProcessedNamespace
options are optional and maintain existing behavior when not specified.
Installation and Upgrade
From Version 1.2.1
This release does not require any special upgrade procedures. Users can continue using existing configurations and deployment methods.
New Installations
Follow the standard installation procedures as documented in the README.md file.
Known Issues
No new known issues have been introduced in this release. For existing known issues, please refer to the Known Issues Details documentation.
Support
For support with the API Publisher, please use Ed-Fi Community Hub to open a support case and/or feature request.
v1.2.1
What's Changed
- [APIPUB-65] SPIKE: Determine rate limiting approach by @jleiva-gap in #69
- [APIPUB-68] SPIKE: Find approach for reverse paging by @DavidJGapCR in #69
- [APIPUB-76] Add Sonar Analyzer to API Publisher and Fix All Warnings C# by @DavidJGapCR in #80
- [APIPUB-66] Implement Rate Limiting by @jleiva-gap in #73
- [APIPUB-69] Implement reverse paging option for API Publisher by @DavidJGapCR in #70
- [APIPUB-72] Develop solution for processing rate limited/left over messages when warned by @jleiva-gap in #74
- [APIPUB-74] Release API Publisher 1.2 by @jpardogrowthaccelerationpartners in #76
Full Changelog: v1.1.0...v1.2.1
v1.1.0
What's Changed
- Apipub10 docupdates by @jasonh-edfi in #30
- Update README.md by @jasonh-edfi in #31
- Update Program.cs by @jasonh-edfi in #32
- Bump Microsoft.Data.SqlClient from 5.1.0 to 5.1.3 in /src/EdFi.Tools.ApiPublisher.ConfigurationStore.SqlServer by @dependabot in #33
- [APIPUB-21] Update publisher workflow and documentation for API v7.1 by @jleiva-gap in #34
- [XXXX] Fix update push nuget package by @jpardogrowthaccelerationpartners in #35
- [APIPUB-25] - [APIPUB-24] - Documentation in relation to key changes and deletes. by @DavidJGapCR in #36
- [APIPUB-33] .NET 8 upgrade by @jleiva-gap in #37
- [APIPUB-33] Fix error On Build (NET 8) by @jleiva-gap in #38
- [APIPUB-33-2] Fix error with download-artifact by @jleiva-gap in #39
- [APIPUB-33] Fix upload-artifact version by @jleiva-gap in #40
- [APIPUB-33-4] Revert upgrade for slsa-github-generator by @jleiva-gap in #41
- [APIPUB-43] API Publisher unable to connect to AWS Parameter Store by @jagudelo-gap in #42
- [APIPUB-38] docker scout configuration by @jpardogrowthaccelerationpartners in #44
- [APIPUB-46] issue closing the logger in AWS CloudWatch by @jagudelo-gap in #45
- [APIPUB-23} Document Docker how to additional instructions by @jpardogrowthaccelerationpartners in https://github.com//pull/46
- Update CONTRIBUTORS.md by @jasonh-edfi in #48
- Bump Npgsql from 8.0.2 to 8.0.3 in /src/EdFi.Tools.ApiPublisher.ConfigurationStore.PostgreSql by @dependabot in #49
- Bump Azure.Identity from 1.10.4 to 1.11.0 in /src/EdFi.Tools.ApiPublisher.ConfigurationStore.SqlServer by @dependabot in #50
- [APIPUB-53] Implementing OSSF Scorecard by @chrisgocode in #51
- [APIPUB-53] Improve Workflow Permissions by @chrisgocode in #52
- [APIPUB-53] Update parameters in on-prerelease.yml by @jpardogrowthaccelerationpartners in #53
- Bump Azure.Identity from 1.11.0 to 1.11.4 in /src/EdFi.Tools.ApiPublisher.ConfigurationStore.SqlServer by @dependabot in #54
- [APIPUB-57] - Profiles Support by @DavidJGapCR in #47
- [APIPUB-52] - Serilog formatting by @jagudelo-gap in #56
- [APIPUB-58] Update docker images and nuget packages to remove vulnerabilites by @jleiva-gap in #59
- [APIPUB-58] Change version for Download SBOM step by @jleiva-gap in #62
- [APIPUB-58] Change version for Download SBOM step by @jleiva-gap in #63
- [APIPUB-59] Update after release pipeline and error on wget by @jpardogrowthaccelerationpartners in #65
- [APIPUB-59] Update pipeline in order to use the latest package by @jpardogrowthaccelerationpartners in #66
- [APIPUB-56] - Release Api Publisher by @jpardogrowthaccelerationpartners in #57
New Contributors
- @dependabot made their first contribution in #33
- @jleiva-gap made their first contribution in #34
- @chrisgocode made their first contribution in #51
Full Changelog: v1.0.0...Pre-Release-v1.1.0
v1.0.0
Api Publisher 1.0.0