JVMCBC-1659 GHA: Automate publishing API reference documentation

Modifications
-------------
Upgrade maven-javadoc-plugin from 3.4.1 to 3.11.2.

NOTE: This changes the output directory from
`target/apidocs` to target/report/apidocs`
for java-client, core-io, and columnar-java-client.

Add an API doc publishing step to the
"release" workflow.

Change-Id: Ibcc71243443dd8e3638bc9923c7d472851bd0d9a
Reviewed-on: https://review.couchbase.org/c/couchbase-jvm-clients/+/229307
Reviewed-by: Graham Pople <[email protected]>
Tested-by: Build Bot <[email protected]>

Author: dnault

.github/workflows/deploy-release.yml

@@ -39,3 +39,19 @@ jobs:
           MAVEN_PASSWORD: ${{ secrets.MAVEN_PASSWORD }}
           MAVEN_GPG_KEY: ${{ secrets.SDK_ROBOT_GPG_PRIVATE_KEY }}
           MAVEN_GPG_PASSPHRASE: ''
+
+      - uses: aws-actions/configure-aws-credentials@v3
+        with:
+          role-to-assume: arn:aws:iam::786014483886:role/SDK_GHA
+          aws-region: us-west-1
+
+      - name: Upload API documentation
+        run: |
+          function upload() {
+            aws s3 cp --recursive --acl public-read $1/$2 s3://docs.couchbase.com/sdk-api/couchbase-$1-${{ inputs.tag }}
+          }
+          upload "core-io" "target/reports/apidocs"
+          upload "java-client" "target/reports/apidocs"
+          upload "scala-client" "target/site/scaladocs"
+          upload "kotlin-client" "target/dokka"
+          upload "columnar-java-client" "target/reports/apidocs"

pom.xml

@@ -50,7 +50,7 @@
 
         <maven-shade-plugin.version>3.2.4</maven-shade-plugin.version>
         <maven-source-plugin.version>3.2.1</maven-source-plugin.version>
-        <maven-javadoc-plugin.version>3.4.1</maven-javadoc-plugin.version>
+        <maven-javadoc-plugin.version>3.11.2</maven-javadoc-plugin.version>
         <build-helper-maven-plugin.version>3.2.0</build-helper-maven-plugin.version>
         <flatten-maven-plugin.version>1.7.0</flatten-maven-plugin.version>
         <scala-maven-plugin.version>4.8.1</scala-maven-plugin.version>