Publishing with curl

Publish a Maven artifact with curl

1. Fetch a CodeArtifact authorization token by following the steps in Pass an auth token using an environment variable and return to these steps.

2. Use the following curl command to publish the JAR to a CodeArtifact repository:

   In each of the curl commands in this procedure, replace the following placeholders:

   • Replace my_domain with your CodeArtifact domain name.

   • Replace 111122223333 with the ID of the owner of your CodeArtifact domain.

   • Replace us-west-2 with the region in which your CodeArtifact domain is located.

   • Replace my_repo with your CodeArtifact repository name.

   curl --request PUT https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/maven/my_repo/com/mycompany/app/my-app/1.0/my-app-1.0.jar \
        --user "aws:$CODEARTIFACT_AUTH_TOKEN" --header "Content-Type: application/octet-stream" \
        --data-binary @my-app-1.0.jar

   Important

   You must prefix the value of the --data-binary parameter with a @ character. When putting the value in quotation marks, the @ must be included inside the quotation marks.

3. Use the following curl command to publish the POM to a CodeArtifact repository:

   curl --request PUT https://my_domain-111122223333.d.codeartifact.us-west-2.amazonaws.com/maven/my_repo/com/mycompany/app/my-app/1.0/my-app-1.0.pom \
        --user "aws:$CODEARTIFACT_AUTH_TOKEN" --header "Content-Type: application/octet-stream" \
        --data-binary @my-app-1.0.pom

4. At this point, the Maven artifact will be in your CodeArtifact repository with a status of Unfinished. To be able to consume the package, it must be in the Published state. You can move the package from Unfinished to Published by either uploading a maven-metadata.xml file to your package, or calling the UpdatePackageVersionsStatus API to change the status.

   1. Option 1: Use the following curl command to add a maven-metadata.xml file to your package:

      curl --request PUT https://my_domain-111122223333.d.codeartifact.region.amazonaws.com/maven/my_repo/com/mycompany/app/my-app/maven-metadata.xml \
           --user "aws:$CODEARTIFACT_AUTH_TOKEN" --header "Content-Type: application/octet-stream" \
           --data-binary @maven-metadata.xml

      The following is an example of the contents of a maven-metadata.xml file:

      <metadata modelVersion="1.1.0">
          <groupId>com.mycompany.app</groupId>
          <artifactId>my-app</artifactId>
          <versioning>
              <latest>1.0</latest>
              <release>1.0</release>
              <versions>
                  <version>1.0</version>
              </versions>
              <lastUpdated>20200731090423</lastUpdated>
          </versioning>
      </metadata>

   2. Option 2: Update the package status to Published with the UpdatePackageVersionsStatus API.

      aws codeartifact update-package-versions-status \
          --domain my_domain \
          --domain-owner 111122223333 \
          --repository my_repo \
          --format maven \
          --namespace com.mycompany.app \
          --package my-app \
          --versions 1.0 \
          --target-status Published