-
Notifications
You must be signed in to change notification settings - Fork 99
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
blog posts - unpublished / placeholder posts currently sit in blog_pr…
…eview sub folder
- Loading branch information
Showing
6 changed files
with
268 additions
and
19 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,90 @@ | ||
| --- | ||
| slug: release-v1.1 | ||
| title: Release v1.1 | ||
| tags: [v1.1, release] | ||
| --- | ||
|
|
||
| Release 1.1 | ||
|
|
||
|
|
||
|
|
||
| ## [1.1.0] - 2023-18-07 | ||
|
|
||
| ### Added | ||
|
|
||
| - Added Electricity Maps (paid api) support for forecasting and historical data. | ||
| - Added ElectricityMaps (free api) support for historical data. Note that this API does not support forecast capabilities. | ||
|
|
||
| ### Fixed | ||
|
|
||
| - Fixed generated test data that had time bomb bug that was in test data, which caused integration tests to fail. This is now automatically generated each time. | ||
| - Fixed some bugs that related to underlying data source errors surfacing as HTTP 500 errors from the API. These should now be more consistent. | ||
| - Fixed an issue where UTF-8 passwords were encoded as ASCII for WattTime API, causing integration failure. | ||
| - Fixes some bugs in unit tests with uncaught scenarios, or faulty tests. | ||
|
|
||
| ### Changed | ||
|
|
||
| - No previous API's were changed. | ||
| - Configuration has changed. Refer to upgrading from 1.0.0 to 1.1.0 below. | ||
| - Time is now always in UTC. Previously the API may have returned local time depending on underlying API. | ||
|
|
||
| #### API | ||
|
|
||
| - `/locations` - Show the list of configured named locations that can be used in the API. | ||
| - `/api/v1/swagger.yaml` - Provides OpenAPI document now at public endpoint when deployed. | ||
|
|
||
| #### API Deployment | ||
|
|
||
| - Configuration has changed. Refer to upgrading from 1.0.0 to 1.1.0 below. | ||
|
|
||
| #### SDK | ||
|
|
||
| - SDK was abstracted to provide a library for DLL import usage, which now allows users to use the SDK in their projects directly without the need to deploy an API. This is useful in scenarios where the API can not be centralised. Note - we still highly recommend centralising for management of the API and audit capabilities with observability. | ||
| - Functionality for forecast and historical data have been seperated into seperate interfaces. This impacts configuration, see upgrading from 1.0.0 to 1.1.0 for more information. | ||
| - Additional tests across the SDK have been added. | ||
| - Aggregation tier in the SDK was removed, this should not impact users of the SDK, but may impact maintainers who were actively contributing. | ||
|
|
||
|
|
||
| #### Other | ||
|
|
||
| - All contributors need to signoff commits for contribution using `git commit -s`. | ||
| - Added PR release workflow improvements for the project management of the CA SDK project team. | ||
| - Updated the project to prune stale PR's and issues to help with the management of the CA SDK project. | ||
|
|
||
|
|
||
| ### Upgrading from 1.0.0 to 1.1.0 | ||
|
|
||
| - Configuration changes are required due to historical and forecast configuration now being decoupled. Refer to - [Configuration](docs/configuration.md) for a guide. The following is provided as an example of the new data source configuration format. | ||
| ```json | ||
| { | ||
| "DataSources": { | ||
| "EmissionsDataSource": "Json", | ||
| "ForecastDataSource": "WattTime", | ||
| "Configurations": { | ||
| "WattTime": { | ||
| "Type": "WattTime", | ||
| "Username": "username", | ||
| "Password": "password", | ||
| "BaseURL": "https://api2.watttime.org/v2/", | ||
| "Proxy": { | ||
| "useProxy": true, | ||
| "url": "http://10.10.10.1", | ||
| "username": "proxyUsername", | ||
| "password": "proxyPassword" | ||
| } | ||
| }, | ||
| "ElectricityMaps": { | ||
| "Type": "ElectricityMaps", | ||
| "APITokenHeader": "auth-token", | ||
| "APIToken": "myAwesomeToken", | ||
| "BaseURL": "https://api.electricitymap.org/v3/" | ||
| }, | ||
| "Json": { | ||
| "Type": "Json", | ||
| "DataFileLocation": "test-data-azure-emissions.json" | ||
| } | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
|
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,90 @@ | ||
| --- | ||
| slug: release-v1.1 | ||
| title: Release v1.1 | ||
| tags: [v1.1, release] | ||
| --- | ||
|
|
||
| Release 1.1 | ||
|
|
||
|
|
||
|
|
||
| ## [1.1.0] - 2023-18-07 | ||
|
|
||
| ### Added | ||
|
|
||
| - Added Electricity Maps (paid api) support for forecasting and historical data. | ||
| - Added ElectricityMaps (free api) support for historical data. Note that this API does not support forecast capabilities. | ||
|
|
||
| ### Fixed | ||
|
|
||
| - Fixed generated test data that had time bomb bug that was in test data, which caused integration tests to fail. This is now automatically generated each time. | ||
| - Fixed some bugs that related to underlying data source errors surfacing as HTTP 500 errors from the API. These should now be more consistent. | ||
| - Fixed an issue where UTF-8 passwords were encoded as ASCII for WattTime API, causing integration failure. | ||
| - Fixes some bugs in unit tests with uncaught scenarios, or faulty tests. | ||
|
|
||
| ### Changed | ||
|
|
||
| - No previous API's were changed. | ||
| - Configuration has changed. Refer to upgrading from 1.0.0 to 1.1.0 below. | ||
| - Time is now always in UTC. Previously the API may have returned local time depending on underlying API. | ||
|
|
||
| #### API | ||
|
|
||
| - `/locations` - Show the list of configured named locations that can be used in the API. | ||
| - `/api/v1/swagger.yaml` - Provides OpenAPI document now at public endpoint when deployed. | ||
|
|
||
| #### API Deployment | ||
|
|
||
| - Configuration has changed. Refer to upgrading from 1.0.0 to 1.1.0 below. | ||
|
|
||
| #### SDK | ||
|
|
||
| - SDK was abstracted to provide a library for DLL import usage, which now allows users to use the SDK in their projects directly without the need to deploy an API. This is useful in scenarios where the API can not be centralised. Note - we still highly recommend centralising for management of the API and audit capabilities with observability. | ||
| - Functionality for forecast and historical data have been seperated into seperate interfaces. This impacts configuration, see upgrading from 1.0.0 to 1.1.0 for more information. | ||
| - Additional tests across the SDK have been added. | ||
| - Aggregation tier in the SDK was removed, this should not impact users of the SDK, but may impact maintainers who were actively contributing. | ||
|
|
||
|
|
||
| #### Other | ||
|
|
||
| - All contributors need to signoff commits for contribution using `git commit -s`. | ||
| - Added PR release workflow improvements for the project management of the CA SDK project team. | ||
| - Updated the project to prune stale PR's and issues to help with the management of the CA SDK project. | ||
|
|
||
|
|
||
| ### Upgrading from 1.0.0 to 1.1.0 | ||
|
|
||
| - Configuration changes are required due to historical and forecast configuration now being decoupled. Refer to - [Configuration](docs/configuration.md) for a guide. The following is provided as an example of the new data source configuration format. | ||
| ```json | ||
| { | ||
| "DataSources": { | ||
| "EmissionsDataSource": "Json", | ||
| "ForecastDataSource": "WattTime", | ||
| "Configurations": { | ||
| "WattTime": { | ||
| "Type": "WattTime", | ||
| "Username": "username", | ||
| "Password": "password", | ||
| "BaseURL": "https://api2.watttime.org/v2/", | ||
| "Proxy": { | ||
| "useProxy": true, | ||
| "url": "http://10.10.10.1", | ||
| "username": "proxyUsername", | ||
| "password": "proxyPassword" | ||
| } | ||
| }, | ||
| "ElectricityMaps": { | ||
| "Type": "ElectricityMaps", | ||
| "APITokenHeader": "auth-token", | ||
| "APIToken": "myAwesomeToken", | ||
| "BaseURL": "https://api.electricitymap.org/v3/" | ||
| }, | ||
| "Json": { | ||
| "Type": "Json", | ||
| "DataFileLocation": "test-data-azure-emissions.json" | ||
| } | ||
| } | ||
| } | ||
| } | ||
| ``` | ||
|
|
This file was deleted.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,45 @@ | ||
| --- | ||
| slug: release-v1.2 | ||
| title: Release v1.2 | ||
| tags: [v1.2, release] | ||
| --- | ||
|
|
||
| Release 1.2 | ||
|
|
||
| ## [1.2.0] - 2024-01 | ||
|
|
||
| ### Added | ||
|
|
||
| - [#381 Add Helm chart and workflow](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/381) | ||
| - New package release for Helm charts available at https://github.com/Green-Software-Foundation/carbon-aware-sdk/pkgs/container/charts%2Fcarbon-aware-sdk | ||
|
|
||
| ### Fixed | ||
|
|
||
| - [#232 Generating SDK client does not work on linux](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/232) | ||
| - [#393 Fix: verify-azure-function-with-packages](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/393) | ||
| - [#391 fixing 3 broken links in overview.md](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/391) | ||
| - [#389 EMFree data source should regard specified time range](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/389) | ||
|
|
||
| ### Changed | ||
|
|
||
| - [#425 Updating CONTRIBUTING.md](https://github.com/Green-Software-Foundation/carbon-aware-sdk/pull/425) | ||
|
|
||
| #### API | ||
|
|
||
| - | ||
|
|
||
| #### API Deployment | ||
|
|
||
| - | ||
|
|
||
| #### SDK | ||
|
|
||
| - | ||
|
|
||
|
|
||
| #### Other | ||
|
|
||
| - Improved process leveraging the project boards at https://github.com/orgs/Green-Software-Foundation/projects/15/views/2 | ||
|
|
||
|
|
||
| For more details, checkout [https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues/232](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues?q=label%3Av1.2+is%3Aclosed+) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,42 @@ | ||
| --- | ||
| slug: release-v1.3 | ||
| title: Release v1.3 | ||
| tags: [v1.3, release] | ||
| --- | ||
|
|
||
| Release 1.3 | ||
|
|
||
|
|
||
|
|
||
|
|
||
| ### Added | ||
|
|
||
| - | ||
|
|
||
| ### Fixed | ||
|
|
||
| - | ||
|
|
||
| ### Changed | ||
|
|
||
| - | ||
|
|
||
| #### API | ||
|
|
||
| - | ||
|
|
||
| #### API Deployment | ||
|
|
||
| - | ||
|
|
||
| #### SDK | ||
|
|
||
| - | ||
|
|
||
|
|
||
| #### Other | ||
|
|
||
| - Improved process leveraging the project boards at https://github.com/orgs/Green-Software-Foundation/projects/15/views/2 | ||
|
|
||
|
|
||
| For more details, checkout [https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues?q=label%3Av1.3+is%3Aclosed+](https://github.com/Green-Software-Foundation/carbon-aware-sdk/issues?q=label%3Av1.3+is%3Aclosed+) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters