EXM-54274 Added section about publishing the DITA XML project to Amaz…

…on S3
oxygenxml · Mar 18, 2024 · b6e1a0e · b6e1a0e
1 parent 6b53fab
commit b6e1a0e
Showing 1 changed file with 11 additions and 0 deletions.
diff --git a/topics/building_validating_and_publishing_using_github_actions.dita b/topics/building_validating_and_publishing_using_github_actions.dita
@@ -41,6 +41,17 @@
                                 href="https://oxygenxmlblog.netlify.app/" format="html"
                                 scope="external"/>.</li>
                     </ol></li>
+                <li>Publish the DITA XML project to an <b>Amazon S3</b> server using a <b>GitHub</b> action:<ol id="ul_aws_s3_publishing">
+                    <li>Create an <b>Amazon S3</b> bucket and configure it for static website hosting. Make note of the bucket name and region.</li>
+                    <li>In the <b>IAM</b> console, create a new user with programmatic access and attach a policy that grants write access to the S3 bucket. Obtain the access key ID and secret access key for this user.</li>
+                    <li>In the GitHub project's <b>Settings->Secrets and variables->Actions</b> category, define variables to store the S3 bucket name, region, access key ID, and secret access key. Also, create a secret for the <b>Oxygen Publishing Engine</b> license key.</li>
+                    <li>Create a custom <xref
+                                href="https://github.com/oxygenxml/blog/blob/master/build/build.gradle"
+                                format="gradle" scope="external">Gradle build file</xref> build file
+                            that downloads the <b>Oxygen Publishing Engine</b>, licenses it,
+                            produces the output, and stores it in a specific folder.</li>
+                    <li>Create a <b>GitHub</b> action that runs the build file and then uses the <xref href="https://github.com/aws-actions/configure-aws-credentials" format="html" scope="external">aws-actions/configure-aws-credentials</xref> action to configure the AWS credentials, followed by the <xref href="https://github.com/aws-actions/s3-sync" format="html" scope="external">aws-actions/s3-sync</xref> action to sync the output folder with the S3 bucket.</li>
+                </ol></li>
                 <li>Validate the entire DITA project using the Oxygen <xref
                         href="https://www.oxygenxml.com/doc/ug-editor/topics/scripting_oxygen_dita_validate_and_check_for_completeness.html"
                         format="html" scope="external"><b>Validate and Check for