[improve][io] Support specifying Kinesis KPL native binary path with 1.0 version specific path

[lhotari]

Motivation

This setting supports building a Pulsar Functions base image that is used to run different Pulsar IO Kinesis
sink versions. The older versions of Pulsar IO Kinesis sink can continue to use the binary configured with
PULSAR_IO_KINESIS_KPL_PATH, pointing to a 0.15.12 native executable.
The newer versions of Pulsar IO Kinesis sink can use the binary configured with PULSAR_IO_KINESIS_KPL_1_0_PATH, pointing to a 1.0.4 native executable.

This use case is relevant for example in the case of Function Mesh base image. streamnative/function-mesh#820 is the PR that depends on this PR.

Kinesis Producer Library (KPL) was upgraded to 1.0.4 in PR #24661.

Modifications

Resolve the default nativeExecutable setting by first checking PULSAR_IO_KINESIS_KPL_1_0_PATH environment variable and then PULSAR_IO_KINESIS_KPL_PATH environment variable.

Documentation

• doc
• doc-required
• doc-not-needed
• doc-complete

[codecov-commenter]

Codecov Report

❌ Patch coverage is 50.00000% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 74.23%. Comparing base (a239240) to head (ad5fb42).

Files with missing lines	Patch %	Lines
...rg/apache/pulsar/io/kinesis/KinesisSinkConfig.java	50.00%	1 Missing and 1 partial ⚠️

Additional details and impacted files

@@              Coverage Diff              @@
##             master   #24669       +/-   ##
=============================================
+ Coverage     34.52%   74.23%   +39.71%     
- Complexity    12835    33196    +20361     
=============================================
  Files          1556     1885      +329     
  Lines        125763   146947    +21184     
  Branches      14379    16928     +2549     
=============================================
+ Hits          43415   109084    +65669     
+ Misses        76419    29161    -47258     
- Partials       5929     8702     +2773     

Flag	Coverage Δ
inttests	26.63% <ø> (?)
systests	22.67% <0.00%> (?)
unittests	73.72% <50.00%> (+39.20%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
...rg/apache/pulsar/io/kinesis/KinesisSinkConfig.java	80.00% <50.00%> (ø)

... and 1537 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.