Merge branch 'master' of https://github.com/liquibase/liquibase-docs

liquibase · Aug 21, 2024 · 17c7564 · 17c7564
2 parents 89391c8 + 4a39871
commit 17c7564
Show file tree

Hide file tree

Showing 20 changed files with 69 additions and 5 deletions.
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/aws-mp-search.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/aws-mp-search.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/aws-mp-view-options.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/aws-mp-view-options.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/compute-opts.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/compute-opts.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/continue-to-config.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/continue-to-config.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/create-revision.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/create-revision.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/ecr.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/ecr.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/fulfillment-option.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/fulfillment-option.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/license-data.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/license-data.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/log-events.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/log-events.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/logs-tab.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/logs-tab.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/revise-task.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/revise-task.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/run-task.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/run-task.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/running-task.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/running-task.png
diff --git a/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/task-def.png b/Content/Z_Resources/Images/Assets/Screenshots/aws-mp/task-def.png
diff --git a/Content/start/release-notes/amazon-dynamodb/home.htm b/Content/start/release-notes/amazon-dynamodb/home.htm
@@ -13,9 +13,9 @@ <h2>Compatibility</h2>
         <MadCap:snippetBlock src="../../../Z_Resources/Snippets/text/database-amazon-dynamodb-compatibility-matrix.flsnp" />
         <p><a href="https://mvnrepository.com/artifact/org.liquibase.ext/liquibase-commercial-dynamodb">Download the latest version of the <MadCap:variable name="General.Liquibase" /> Amazon&#160;DynamoDB Extension here.</a>
         </p>
-        <h2>Amazon&#160;DynamoDB 1.1.0 – August 6, 2024</h2>
+        <h2>Amazon&#160;DynamoDB 1.0.1 – August 6, 2024</h2>
         <p>This release contains support for the <code><MadCap:xref href="../../../commands/change-tracking/connect.htm">connect</MadCap:xref></code> command, resolves sonar issues, to run tests against real cloud infrastructure, and many back-end software updates. </p>
-        <p>For more information, see <MadCap:xref href="amazon-dynamodb-1.0.1.htm">[%=General.Liquibase%] Amazon DynamoDB 1.1.0 Release Notes</MadCap:xref>.</p>
+        <p>For more information, see <MadCap:xref href="amazon-dynamodb-1.0.1.htm">[%=General.Liquibase%] Amazon DynamoDB 1.0.1 Release Notes</MadCap:xref>.</p>
         <h2>Amazon&#160;DynamoDB 1.0.0 – March 19, 2024</h2>
         <p>Initial release of the <MadCap:variable name="General.Liquibase" /> Amazon DynamoDB extension. Contains support for XML, YAML, and JSON <MadCap:variable name="General.changelog" />s, as well as partial PartiQL support. Support for many <MadCap:variable name="General.LBPro" /> features is included.</p>
         <p>For more information, see <MadCap:xref href="amazon-dynamodb-1.0.0.htm">[%=General.Liquibase%] Amazon DynamoDB 1.0.0 Release Notes</MadCap:xref>.</p>

diff --git a/Content/tools-integrations/aws-mp/purchase-liquibase-aws.htm b/Content/tools-integrations/aws-mp/purchase-liquibase-aws.htm
@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd">
+    <head><title><MadCap:variable name="Heading.Level1" /></title>
+        <link rel="canonical" href="https://docs.liquibase.com/tools-integrations/aws-mp/purchase-liquibase-aws.html" />
+        <meta name="description" content="This page teaches you how to purchase Liquibase on AWS Marketplace." />
+        <meta name="viewport" content="width=device-width, initial-scale=1" />
+    </head>
+    <body>
+        <h1>Purchase <MadCap:variable name="General.Liquibase" /> on AWS&#160;Marketplace</h1>
+        <p>Follow this guide to purchase and launch <MadCap:variable name="General.Liquibase" /> from AWS&#160;Marketplace.</p>
+        <ol>
+            <li>Login to the <a href="https://liquibase.awsapps.com/start/#/?tab=accounts">AWS access portal</a>.</li>
+            <li>Search for <MadCap:variable name="General.LBPro" />.</li>
+            <li>Select the <MadCap:variable name="General.LBPro" /> 4.29.1 option.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/aws-mp-search.png" class="thumbnail" /></li>
+            <li>Click the <b>View purchase options</b> button.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/aws-mp-view-options.png" class="thumbnail" /></li>
+            <li>Configure your software contract by selecting:<ol><li>How long the contract will run</li><li>If you want <MadCap:variable name="General.Liquibase" /> to automatically renew</li><li>How many datastore targets you need</li></ol></li>
+            <li>Click the <b>Continue to Configuration</b> button.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/continue-to-config.png" class="thumbnail" /></li>
+            <li>Choose a fulfillment option and software version to launch <MadCap:variable name="General.Liquibase" />. In this example <MadCap:variable name="General.Liquibase" /> Pro Docker image is the fulfillment option and 4.29.1 is the software version.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/fulfillment-option.png" class="thumbnail" /></li>
+            <li>Click the <b>Continue to Launch</b> button.</li>
+            <li>Once <MadCap:variable name="General.Liquibase" /> launches,  you will see the <MadCap:variable name="General.LBPro" /> license and all of its data under the AWS License Manager section.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/license-data.png" class="thumbnail" /></li>
+        </ol>
+    </body>
+</html>
diff --git a/Content/tools-integrations/aws-mp/run-commands-aws.htm b/Content/tools-integrations/aws-mp/run-commands-aws.htm
@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="utf-8"?>
+<html xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd">
+	<head><title><MadCap:variable name="Heading.Level1" /></title>
+		<link rel="canonical" href="https://docs.liquibase.com/tools-integrations/aws-mp/run-commands-aws.html" />
+		<meta name="description" content="This page teaches you how to run Liquibase commands on AWS Marketplace." />
+		<meta name="viewport" content="width=device-width, initial-scale=1" />
+	</head>
+    <body>
+        <h1>Run <MadCap:variable name="General.Liquibase"></MadCap:variable> commands on AWS</h1>
+        <p>This guide covers how to run <MadCap:variable name="General.Liquibase" /> commands against the purchased license with AWS&#160;tools such as AWS&#160;Fargate, Amazon Elastic Container Service (ECS), Amazon Elastic Kubernetes Service (EKS), AWS CodePipeline, and AWS CloudFormation.</p>
+        <ol>
+            <li>Search and select in the AWS&#160;search bar search for the tool of your choice. In this example we are using Amazon Elastic Container Service (ECS).<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/ecr.png" class="thumbnail" /></li>
+            <li>Navigate to the&#160;<b>Task definitions</b> section on the left side navigation. Task definitions are equivalent to <MadCap:variable name="General.Liquibase" /> commands, and all tested definitions are available in this window.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/task-def.png" class="thumbnail" /><ol><li><b>Optional:&#160;Locate the full image URL in a task definition to extend the docker image</b><br />This is where you may want to extend the docker image. To extend our docker image and add other databases  for a specific task definition, you must use the image URL that displays the ECR&#160;repository. The steps below will show you how to locate this image URL.<br /><p class="note" MadCap:autonum="&lt;b&gt;Note: &lt;/b&gt;">As of Liquibase 4.29.1 AWS&#160;does not support custom domain names for Amazon ECR.</p></li><li><p>From the <b>Task definitions</b> section, select a task definition you want to extend the docker image of.</p></li><li><p>Check the box next to the specific definition you want to revise.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/revise-task.png" class="thumbnail" /></p></li><li><p>Click the <b>Create new revision</b> drop down menu and select <b>Create new revision</b>.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/create-revision.png" class="thumbnail" /></p></li><li><p>From the Create new revision page you will see the image URL which is the ECR repository. This URL will be used when you extend the docker image.</p></li></ol></li>
+            <li>Run a task definition by selecting the radio button next to the desired definition. In this example we will use update-command.<br /></li>
+            <li>Select the <b>Deploy button</b> at the top of the screen.</li>
+            <li>From the drop-down menu, select <b>run task</b>.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/run-task.png" class="thumbnail" /></li>
+            <li>Select the <b>Compute</b> options that you desire. In this example we will toggle Launch type on.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/compute-opts.png" class="thumbnail" /></li>
+            <li>Click the <b>Create</b> button.</li>
+            <li>AWS will bring you to the tasks in your cluster. You will be able to see the task that is running in the Tasks tab below the Cluster Overview.<br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/running-task.png" class="thumbnail" /></li>
+            <li>Click on the <b>task</b> that is running in the Tasks tab.</li>
+            <li>Click on the <b>Logs tab</b> to see all log events on any container you have access to. <br /><img src="../../Z_Resources/Images/Assets/Screenshots/aws-mp/logs-tab.png" class="thumbnail" /><br />This message will display if you <b>have</b> a license: <MadCap:variable name="General.Liquibase" /> Pro 4.29.1 (license through AWS License Manager)<br />This message will display if you <b>do not have</b> a license:&#160;<MadCap:variable name="General.Liquibase" /> Version: 4.29.1</li>
+        </ol>
+        <p>You have successfully ran and viewed the logs of a <MadCap:variable name="General.Liquibase" /> command on AWS.</p>
+    </body>
+</html>
diff --git a/Content/workflows/liquibase-community/using-liquibase-and-docker.htm b/Content/workflows/liquibase-community/using-liquibase-and-docker.htm
@@ -24,7 +24,9 @@ <h2><MadCap:variable name="General.Liquibase" /> Docker container image</h2>
         </ul>
         <p class="note" MadCap:autonum="&lt;b&gt;Note: &lt;/b&gt;">The database drivers for MongoDB&#160;Pro and MySQL are not preinstalled into the container image and require additional steps to install. See <MadCap:xref href="#MongoDB">MongoDB Pro driver</MadCap:xref> and <MadCap:xref href="#MySQL">MySQL driver</MadCap:xref>.</p>
         <p>See the <a href="https://github.com/liquibase/docker/blob/main/Dockerfile"><MadCap:variable name="General.Liquibase" /> Dockerfile</a> for more details. You can find the official repository for <MadCap:variable name="General.Liquibase" /> images on the <a href="https://download.liquibase.org/">download</a> page.</p>
-        <p>Docker pull command:</p><pre><code class="language-text">docker pull liquibase/liquibase</code></pre>
+        <p>Docker pull command:</p>
+        <p>4.27.0 and after:</p><pre><code class="language-text">docker pull liquibase</code></pre>
+        <p>4.26.0 and before:</p><pre><code class="language-text">docker pull liquibase/liquibase</code></pre>
         <h3>Example JDBC URLs</h3>
         <table>
             <col style="width: 600px;" />
@@ -126,7 +128,9 @@ <h3><a name="MongoDB"></a>MongoDB Pro driver</h3>
         <h3 id="mysql"><a name="MySQL"></a>MySQL driver</h3>
         <p>The JDBC driver for MySQL has licensing restrictions that prevent it from being preinstalled into the container image. You must load the driver in one of the following ways:</p>
         <h4>Create a new container</h4>
-        <p>Dockerfile:</p><pre xml:space="preserve"><code class="language-text">FROM liquibase/liquibase
+        <p>Dockerfile:</p>
+        <p>4.27.0 and after:</p><pre><code class="language-text">FROM liquibase:latest</code></pre>
+        <p>4.26.0 and before:</p><pre xml:space="preserve"><code class="language-text">FROM liquibase/liquibase
 RUN lpm add mysql --global</code></pre>
         <p>Then enter this command in the CLI:</p><pre><code class="language-text">docker build . -t liquibase/liquibase-mysql</code></pre>
         <p>For more information, see <a href="https://docs.docker.com/engine/reference/commandline/build/">docker build</a>.</p>

diff --git a/Project/TOCs/TOC.fltoc b/Project/TOCs/TOC.fltoc
@@ -1416,6 +1416,18 @@
           Link="/Content/tools-integrations/ant/commands/updatedatabase.html" />
       </TocEntry>
     </TocEntry>
+    <TocEntry
+      Title="AWS Marketplace"
+      Link="/Content/tools-integrations/aws-mp/purchase-liquibase-aws.htm">
+      <TocEntry
+        Title="[%=System.LinkedTitle%]"
+        Link="/Content/tools-integrations/aws-mp/purchase-liquibase-aws.htm"
+        MadCap:generatedToc="true" xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" />
+      <TocEntry
+        Title="[%=System.LinkedTitle%]"
+        Link="/Content/tools-integrations/aws-mp/run-commands-aws.htm"
+        MadCap:generatedToc="true" xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" />
+    </TocEntry>
     <TocEntry
       Title="[%=System.LinkedTitle%]"
       Link="/Content/tools-integrations/community-supported.htm" xmlns:MadCap="http://www.madcapsoftware.com/Schemas/MadCap.xsd" />

diff --git a/Project/Targets/HTML5-PRO.fltar b/Project/Targets/HTML5-PRO.fltar
@@ -40,7 +40,7 @@
     OutputFormat="doc" />
   <Destinations>
     <Destination
-      Link="/Project/Destinations/DocsStageAV.fldes"
+      Link="/Project/Destinations/DocsStageAW.fldes"
       Publish="true"
       IsResource="false" />
   </Destinations>