Skip to content

Commit

Permalink
[APIPUB-74] - Release Api Publisher (#76)
Browse files Browse the repository at this point in the history
  • Loading branch information
jpardogrowthaccelerationpartners authored Sep 19, 2024
1 parent e2e0742 commit 345a95f
Show file tree
Hide file tree
Showing 3 changed files with 7 additions and 5 deletions.
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,13 +37,13 @@ The API Publisher has three options to use the product. The API Publisher requi

#### Option 1 - From binaries

1. Download the latest published API Publisher package here: [Ed-Fi API Publisher v1.0](https://dev.azure.com/ed-fi-alliance/Ed-Fi-Alliance-OSS/_artifacts/feed/EdFi/NuGet/EdFi.ApiPublisher/overview/1.1.0). Visit the page and click download.
2. This will download a NuGet package to your computer. Rename this file, `EdFi.ApiPublisher.1.1.0.nupkg`, to include .zip extension: `EdFi.ApiPublisher.1.1.0.zip`.
1. Download the latest published API Publisher package here: [Ed-Fi API Publisher v1.2](https://dev.azure.com/ed-fi-alliance/Ed-Fi-Alliance-OSS/_artifacts/feed/EdFi/NuGet/EdFi.ApiPublisher/overview/1.2.0). Visit the page and click download.
2. This will download a NuGet package to your computer. Rename this file, `EdFi.ApiPublisher.1.2.0.nupkg`, to include .zip extension: `EdFi.ApiPublisher.1.2.0.zip`.
3. The binary mentioned below is in the `EdFi.ApiPublisher.Win64` folder, as `EdFiApiPublisher.exe`.

#### Option 2 - From Docker images

The Docker image for the Ed-Fi API Publisher is available here: [Ed-Fi API Publisher v1.0 on Docker Hub](https://hub.docker.com/layers/edfialliance/ods-api-publisher/v1.1.0/images/sha256-4930ca34fbc71dee2fbbec09c904f980d86db536e0486f713fd03341ea5854d5?context=explore). Use this to include in your Docker environment and alongside other components of the Ed-Fi stack.
The Docker image for the Ed-Fi API Publisher is available here: [Ed-Fi API Publisher tag v1.2 on Docker Hub](https://hub.docker.com/r/edfialliance/ods-api-publisher/tags). Use this to include in your Docker environment and alongside other components of the Ed-Fi stack.

#### Option 3 - Build the API Publisher from source code

Expand Down Expand Up @@ -95,7 +95,7 @@ For more information in relation to key changes and deletes, please see [Conside

## Known Limitations for Ed-Fi ODS / API 5.1 through 5.3

Currently, Ed-Fi ODS / API 5.1 through 5.3 has the following known issues related to Change Queries and the Ed-Fi API Publisher. These have been resolved in [Ed-Fi ODS / API 5.3-cqe patch](https://techdocs.ed-fi.org/display/EFTD/Change+Query+Enhancements) and [Ed-Fi ODS / API 6.1](https://techdocs.ed-fi.org/pages/viewpage.action?pageId=138642238).
Currently, Ed-Fi ODS / API 5.1 through 5.3 has the following known issues related to Change Queries and the Ed-Fi API Publisher. These have been resolved in [Ed-Fi ODS / API 5.3-cqe patch](https://edfi.atlassian.net/wiki/spaces/EFTD/pages/24807016/Change+Query+Enhancements) and [Ed-Fi ODS / API 6.1](https://edfi.atlassian.net/wiki/spaces/ODSAPIS3V61/overview).

* [Change Queries implementation doesn't provide enough information to communicate deletes between ODS databases](https://tracker.ed-fi.org/browse/ODS-3672)
* [Add support to Change Queries for tracking deletes by natural key](https://tracker.ed-fi.org/browse/ODS-4423)
Expand Down Expand Up @@ -131,7 +131,7 @@ For support with the API Publisher, please use [Ed-Fi Support](https://support.e

## Legal Information

Copyright (c) 2023 Ed-Fi Alliance, LLC and contributors.
Copyright (c) 2024 Ed-Fi Alliance, LLC and contributors.

Licensed under the [Apache License, Version 2.0](LICENSE) (the "License").

Expand Down
1 change: 1 addition & 0 deletions docs/API-Publisher-Configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ Defines general behavior of the Ed-Fi API Publisher.
| Options:RateLimitNumberExecutions<br/>`--rateLimitNumberExecutions` | Indicates the maximum number of executions allowed within the defined time window.<br/>(_Default value: 30_) |
| Options:RateLimitTimeSeconds<br/>`--rateLimitTimeSeconds` | Indicates the the time span for the rate limit in seconds.<br/>(_Default value: 1_) |
| Options:RateLimitMaxRetries<br/>`--rateLimitMaxRetries` | Indicates the number of times the Ed-Fi API publisher will attempt to _resend_ a request, rejected by rate limiting, to the source or destination APIs before determining that the failure is permanent.<br/>(_Default value: 10_) |
| Options:useReversePaging<br/>`--useReversePaging` | Indicates whether or not to use reverse paging mode. For more information about this feature read [here](Reverse-Paging.md).<br/>(_Default value: false_) |

## API Connections

Expand Down
1 change: 1 addition & 0 deletions src/Dockerfile
Original file line number Diff line number Diff line change
Expand Up @@ -33,3 +33,4 @@ RUN apk --no-cache add unzip=~6 dos2unix=~7 bash=~5 gettext=~0 postgresql13-clie
rm -f /app/*.exe

ENTRYPOINT [ "/app/run.sh" ]

0 comments on commit 345a95f

Please sign in to comment.