Skip to content

Commit 24905bd

Browse files
committed
Fix links for 0.13.0
1. Some links and text refers to 0.13 where it should be 0.13.0 2. Some links referred to main where they should point at a version specific location on github, tied to the release tag. Partially resolves kroxylicious/kroxylicious#2478 Signed-off-by: Robert Young <[email protected]>
1 parent 52e8dcb commit 24905bd

File tree

4 files changed

+16
-16
lines changed

4 files changed

+16
-16
lines changed

documentation/0.13.0/html/developer-guide/content.html

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -91,13 +91,13 @@ <h2 id="con-custom-filters-proxy">2. Custom filters</h2>
9191
<div class="sect2">
9292
<h3 id="sample_custom_filter_project">2.1. Sample Custom Filter Project</h3>
9393
<div class="paragraph">
94-
<p>A collection of sample filters is available within the Kroxylicious repository for you to download, try out, and customise. You can find them <a href="https://github.com/kroxylicious/kroxylicious/tree/main/kroxylicious-sample">here</a> for a hands-on introduction to creating your own custom filters.</p>
94+
<p>A collection of sample filters is available within the Kroxylicious repository for you to download, try out, and customise. You can find them <a href="https://github.com/kroxylicious/kroxylicious/tree/v0.13.0/kroxylicious-sample">here</a> for a hands-on introduction to creating your own custom filters.</p>
9595
</div>
9696
</div>
9797
<div class="sect2">
9898
<h3 id="api_docs">2.2. API docs</h3>
9999
<div class="paragraph">
100-
<p>Custom filters are built by implementing interfaces supplied by the <a href="https://github.com/kroxylicious/kroxylicious/tree/main/kroxylicious-api" target="_blank" rel="noopener">kroxylicious-api</a> module (<a href="https://mvnrepository.com/artifact/io.kroxylicious/kroxylicious-api">io.kroxylicious:kroxylicious-api</a> on maven central). You can view the javadoc <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/filter/package-summary.html" target="_blank" rel="noopener">here</a>.</p>
100+
<p>Custom filters are built by implementing interfaces supplied by the <a href="https://github.com/kroxylicious/kroxylicious/tree/v0.13.0/kroxylicious-api" target="_blank" rel="noopener">kroxylicious-api</a> module (<a href="https://mvnrepository.com/artifact/io.kroxylicious/kroxylicious-api">io.kroxylicious:kroxylicious-api</a> on maven central). You can view the javadoc <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/filter/package-summary.html" target="_blank" rel="noopener">here</a>.</p>
101101
</div>
102102
</div>
103103
<div class="sect2">
@@ -138,7 +138,7 @@ <h4 id="specific_message_protocol_filters">2.4.1. Specific Message Protocol Filt
138138
<div class="sect4">
139139
<h5 id="examples">Examples</h5>
140140
<div class="paragraph">
141-
<p>To intercept all Fetch Requests your class would implement <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/filter/FetchRequestFilter.html" target="_blank" rel="noopener">FetchRequestFilter</a>:</p>
141+
<p>To intercept all Fetch Requests your class would implement <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/filter/FetchRequestFilter.html" target="_blank" rel="noopener">FetchRequestFilter</a>:</p>
142142
</div>
143143
<div class="listingblock">
144144
<div class="content">
@@ -156,7 +156,7 @@ <h5 id="examples">Examples</h5>
156156
</div>
157157
</div>
158158
<div class="paragraph">
159-
<p>To intercept all Fetch Responses your class would implement <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/filter/FetchResponseFilter.html" target="_blank" rel="noopener">FetchResponseFilter</a>:</p>
159+
<p>To intercept all Fetch Responses your class would implement <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/filter/FetchResponseFilter.html" target="_blank" rel="noopener">FetchResponseFilter</a>:</p>
160160
</div>
161161
<div class="listingblock">
162162
<div class="content">
@@ -174,7 +174,7 @@ <h5 id="examples">Examples</h5>
174174
</div>
175175
</div>
176176
<div class="paragraph">
177-
<p>To intercept all Fetch Requests and all Fetch Responses your class would implement <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/filter/FetchRequestFilter.html" target="_blank" rel="noopener">FetchRequestFilter</a> and <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/filter/FetchResponseFilter.html" target="_blank" rel="noopener">FetchResponseFilter</a>:</p>
177+
<p>To intercept all Fetch Requests and all Fetch Responses your class would implement <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/filter/FetchRequestFilter.html" target="_blank" rel="noopener">FetchRequestFilter</a> and <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/filter/FetchResponseFilter.html" target="_blank" rel="noopener">FetchResponseFilter</a>:</p>
178178
</div>
179179
<div class="listingblock">
180180
<div class="content">
@@ -213,10 +213,10 @@ <h4 id="requestresponse_protocol_filters">2.4.2. Request/Response Protocol Filte
213213
<div class="ulist">
214214
<ul>
215215
<li>
216-
<p><a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/filter/RequestFilter.html" target="_blank" rel="noopener">RequestFilter</a> to intercept all requests.</p>
216+
<p><a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/filter/RequestFilter.html" target="_blank" rel="noopener">RequestFilter</a> to intercept all requests.</p>
217217
</li>
218218
<li>
219-
<p><a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/filter/ResponseFilter.html" target="_blank" rel="noopener">ResponseFilter</a> to intercept all responses.</p>
219+
<p><a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/filter/ResponseFilter.html" target="_blank" rel="noopener">ResponseFilter</a> to intercept all responses.</p>
220220
</li>
221221
</ul>
222222
</div>
@@ -351,7 +351,7 @@ <h4 id="handling_state">2.4.5. Handling state</h4>
351351
<p>The simplest way of managing per-client state is to use member fields. The proxy guarantees that all methods of a given filter instance will always be invoked on the same thread (also true of the CompletionStage completion in the case of <a href="#sending_asynchronous_requests_to_the_cluster">Sending asynchronous requests to the Cluster</a>). Therefore, there is no need to use synchronization when accessing such fields.</p>
352352
</div>
353353
<div class="paragraph">
354-
<p>See the <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/filter/package-summary.html#implementing.threadSafety" target="_blank" rel="noopener"><code>io.kroxylicious.proxy.filter</code></a> package javadoc for more information on thread-safety.</p>
354+
<p>See the <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/filter/package-summary.html#implementing.threadSafety" target="_blank" rel="noopener"><code>io.kroxylicious.proxy.filter</code></a> package javadoc for more information on thread-safety.</p>
355355
</div>
356356
</div>
357357
<div class="sect3">
@@ -571,14 +571,14 @@ <h5 id="sending_asynchronous_requests_to_the_cluster">Sending asynchronous reque
571571
</table>
572572
</div>
573573
<div class="paragraph">
574-
<p>As you have read above, we need to know the API version we want our request to be encoded at. Your filter can discover what versions of an API the Kafka Cluster supports. To do this use the <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/ApiVersionsService.html" target="_blank" rel="noopener">ApiVersionsService</a> available from the <code>FilterContext</code> to determine programmatically what versions of an API are support and then write code to make a suitable <code>request</code> object.</p>
574+
<p>As you have read above, we need to know the API version we want our request to be encoded at. Your filter can discover what versions of an API the Kafka Cluster supports. To do this use the <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/ApiVersionsService.html" target="_blank" rel="noopener">ApiVersionsService</a> available from the <code>FilterContext</code> to determine programmatically what versions of an API are support and then write code to make a suitable <code>request</code> object.</p>
575575
</div>
576576
<div class="admonitionblock note">
577577
<table>
578578
<tbody>
579579
<tr>
580580
<td class="icon"><i class="fa icon-note" title="Note"></i></td>
581-
<td class="content">Kroxylicious provides the guarantee that computation stages chained using the <em>default execution methods</em> are executed on the same thread as the rest of the Filter work, so we can safely mutate Filter members without synchronising. See the <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/filter/package-summary.html#implementing.threadSafety" target="_blank" rel="noopener"><code>io.kroxylicious.proxy.filter</code></a> package javadoc for more information on thread-safety.</td>
581+
<td class="content">Kroxylicious provides the guarantee that computation stages chained using the <em>default execution methods</em> are executed on the same thread as the rest of the Filter work, so we can safely mutate Filter members without synchronising. See the <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/filter/package-summary.html#implementing.threadSafety" target="_blank" rel="noopener"><code>io.kroxylicious.proxy.filter</code></a> package javadoc for more information on thread-safety.</td>
582582
</tr>
583583
</tbody>
584584
</table>
@@ -630,10 +630,10 @@ <h5 id="filtering_specific_api_versions">Filtering specific API Versions</h5>
630630
<div class="sect3">
631631
<h4 id="filter_construction_and_configuration">2.4.7. Filter Construction and Configuration</h4>
632632
<div class="paragraph">
633-
<p>For Kroxylicious to instantiate and configure your custom filter we use Java’s <a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/ServiceLoader.html" target="_blank" rel="noopener">ServiceLoader</a> API. Each Custom Filter should provide a corresponding <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13/io/kroxylicious/proxy/filter/FilterFactory.html" target="_blank" rel="noopener">FilterFactory</a> implementation that can create an instance of your custom Filter. The factory can optionally declare a configuration class that Kroxylicious will populate (using Jackson) when loading your custom Filter. The module must package a <code>META-INF/services/io.kroxylicious.proxy.filter.FilterFactory</code> file containing the classnames of each filter factory implementation into the JAR file.</p>
633+
<p>For Kroxylicious to instantiate and configure your custom filter we use Java’s <a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/ServiceLoader.html" target="_blank" rel="noopener">ServiceLoader</a> API. Each Custom Filter should provide a corresponding <a href="https://javadoc.io/doc/io.kroxylicious/kroxylicious-api/0.13.0/io/kroxylicious/proxy/filter/FilterFactory.html" target="_blank" rel="noopener">FilterFactory</a> implementation that can create an instance of your custom Filter. The factory can optionally declare a configuration class that Kroxylicious will populate (using Jackson) when loading your custom Filter. The module must package a <code>META-INF/services/io.kroxylicious.proxy.filter.FilterFactory</code> file containing the classnames of each filter factory implementation into the JAR file.</p>
634634
</div>
635635
<div class="paragraph">
636-
<p>For example in the kroxylicious-samples we have the <a href="https://github.com/kroxylicious/kroxylicious/blob/main/kroxylicious-sample/src/main/java/io/kroxylicious/sample/config/SampleFilterConfig.java">SampleFilterConfig</a> class. This is used in the <a href="https://github.com/kroxylicious/kroxylicious/blob/main/kroxylicious-sample/src/main/java/io/kroxylicious/sample/SampleFetchResponseFilter.java">SampleFetchResponseFilter</a>). The configuration is routed to the Filter instance via the <a href="https://github.com/kroxylicious/kroxylicious/blob/main/kroxylicious-sample/src/main/java/io/kroxylicious/sample/SampleFetchResponse.java">SampleFetchResponse</a>.</p>
636+
<p>For example in the kroxylicious-samples we have the <a href="https://github.com/kroxylicious/kroxylicious/blob/v0.13.0/kroxylicious-sample/src/main/java/io/kroxylicious/sample/config/SampleFilterConfig.java">SampleFilterConfig</a> class. This is used in the <a href="https://github.com/kroxylicious/kroxylicious/blob/v0.13.0/kroxylicious-sample/src/main/java/io/kroxylicious/sample/SampleFetchResponseFilter.java">SampleFetchResponseFilter</a>). The configuration is routed to the Filter instance via the <a href="https://github.com/kroxylicious/kroxylicious/blob/v0.13.0/kroxylicious-sample/src/main/java/io/kroxylicious/sample/SampleFetchResponse.java">SampleFetchResponse</a>.</p>
637637
</div>
638638
<div class="paragraph">
639639
<p>Then, when we configure a filter in Kroxylicious configuration like:</p>

documentation/0.13.0/html/kroxylicious-operator/content.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -175,7 +175,7 @@ <h3 id="install-prereqs-operator">3.1. Install prerequisites</h3>
175175
<div class="sect2">
176176
<h3 id="downloads-operator">3.2. Kroxylicious release artifacts</h3>
177177
<div class="paragraph _abstract">
178-
<p>To use YAML manifest files to install Kroxylicious, download kroxylicious-operator-0.13.zip or kroxylicious-operator-0.13.tar.gz file from the <a href="https://github.com/kroxylicious/kroxylicious/releases" target="_blank" rel="noopener">GitHub releases page</a>, and extract the files as appropriate (for example using <code>unzip</code> or <code>tar -xzf</code>).</p>
178+
<p>To use YAML manifest files to install Kroxylicious, download kroxylicious-operator-0.13.0.zip or kroxylicious-operator-0.13.0.tar.gz file from the <a href="https://github.com/kroxylicious/kroxylicious/releases" target="_blank" rel="noopener">GitHub releases page</a>, and extract the files as appropriate (for example using <code>unzip</code> or <code>tar -xzf</code>).</p>
179179
</div>
180180
<div class="paragraph">
181181
<p>Each of these archives contains:</p>
@@ -205,7 +205,7 @@ <h3 id="install-cluster-operator-operator">3.3. Installing the Kroxylicious Oper
205205
<p>You need an account with permission to create and manage <code>CustomResourceDefinition</code> and RBAC (<code>ClusterRole</code>) resources.</p>
206206
</li>
207207
<li>
208-
<p>You have downloaded one of kroxylicious-operator-0.13.zip or kroxylicious-operator-0.13.tar.gz and extracted the contents into the current directory.</p>
208+
<p>You have downloaded one of kroxylicious-operator-0.13.0.zip or kroxylicious-operator-0.13.0.tar.gz and extracted the contents into the current directory.</p>
209209
</li>
210210
</ul>
211211
</div>

documentation/0.13.0/html/kroxylicious-proxy/content.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2677,7 +2677,7 @@ <h4 id="using_micrometer_with_filters">5.4.3. Using Micrometer with filters</h4>
26772677
<div class="sect2">
26782678
<h3 id="proc-proxy-setting-log-levels-proxy">5.5. Setting log levels</h3>
26792679
<div class="paragraph _abstract">
2680-
<p>The Kroxylicious <a href="https://github.com/kroxylicious/kroxylicious/tree/main" target="_blank" rel="noopener">binary distribution</a> includes <a href="https://logging.apache.org/log4j/2.x">log4j2</a> as the default logging backend.</p>
2680+
<p>The Kroxylicious <a href="https://github.com/kroxylicious/kroxylicious/releases/download/v0.13.0/kroxylicious-app-0.13.0-bin.zip" target="_blank" rel="noopener">binary distribution</a> includes <a href="https://logging.apache.org/log4j/2.x">log4j2</a> as the default logging backend.</p>
26812681
</div>
26822682
<div class="paragraph">
26832683
<p>When using the <code>bin/kroxylicious-start.sh</code> script from the binary distribution, you can set an environment variable to load a custom <code>log4j2</code> configuration file or change the root logging level.</p>

documentation/0.13.0/html/record-encryption-guide/content.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -408,7 +408,7 @@ <h5 id="establish_an_application_identity_for_the_filter">Establish an applicati
408408
<div class="sect4">
409409
<h5 id="testing_the_application_identity_for_the_filter_using_the_cli">Testing the application identity for the filter using the CLI</h5>
410410
<div class="paragraph">
411-
<p>To test whether the application identity and the policy are working correctly, a <a href="https://raw.githubusercontent.com/kroxylicious/kroxylicious/main/scripts/validate_vault_token.sh">script</a> can be used.</p>
411+
<p>To test whether the application identity and the policy are working correctly, a <a href="https://raw.githubusercontent.com/kroxylicious/kroxylicious/v0.13.0/scripts/validate_vault_token.sh">script</a> can be used.</p>
412412
</div>
413413
<div class="paragraph">
414414
<p>First, as the administrator, create a KEK in the hierarchy at this path <code>transit/keys/KEK_testkey</code>.</p>

0 commit comments

Comments
 (0)