Git-Mirrors/constellation
1
0
Fork 0
mirror of https://github.com/edgelesssys/constellation.git synced 2025-04-06 05:56:28 -04:00
Code Issues Packages Projects Releases Wiki Activity

dev-docs: Add guide on publishing marketplace images (#3734)

Browse Source 
Signed-off-by: Moritz Sanft <58110325+msanft@users.noreply.github.com>
This commit is contained in:
Moritz Sanft 2025-04-02 16:21:19 +02:00 committed by GitHub
parent 88ca92509c
commit fa21c55f5d
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 34 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
dev-docs/workflows/marketplace-publishing.md Normal file
View File

@ -0,0 +1,33 @@
# Publishing Marketplace Images
Constellation release images need to be manually published to AWS and Azure marketplaces due to the lack of automation features.
On GCP, marketplace image publishing is automated and takes place on release.
This document explains how to perform the uploading on AWS and Azure.
## AWS
1. Log in to the [AWS marketplace management portal](https://aws.amazon.com/marketplace/management/) with your regular developer AWS account.
2. Select "Products -> Server -> Constellation" in the top menu.
3. Select "Versions" in the main menu and press "Add version".
4. Fill in the form.
1. Enter the semantic version of the release (i.e. `vX.Y.Z`) as "Version title".
2. Set the version tag in "Release notes" to the same version.
3. For the "Amazon Machine Image (AMI) ID", enter the AMI ID of the release (SEV-SNP) image. This can be found in the regular
[AWS console](https://us-east-1.console.aws.amazon.com/ec2/home?region=us-east-1#Images:visibility=owned-by-me;search=:constellation-v;v=3;$case=tags:false%5C,client:false;$regex=tags:false%5C,client:false;sort=desc:creationDate).
4. For "IAM access role ARN", enter `arn:aws:iam::795746500882:role/constellation-marketplace-ingest`.
5. Leave the other fields as they are and press "Add version".
6. Wait for the [request](https://aws.amazon.com/marketplace/management/requests) to be processed and available before publishing the release.
## Azure
1. Log in to the [Microsoft partner center](https://partner.microsoft.com/en-us/dashboard/home) with your regular developer Microsoft account.
2. Select "Marketplace offers -> Constellation -> Constellation Node" in the main menu.
3. Select "Technical configuration" in the sidebar on the left.
4. Select "Add VM Image".
1. For the "Version number", enter the semantic version of the release without the `v` prefix. If the release version is `vX.Y.Z`, enter `X.Y.Z`.
2. Press "Add a gallery image" and select the corresponding "Constellation_CVM" image version in the menu.
3. Press "Save VM image".
5. **IMPORTANT**: Hit **Save draft**. Do **NOT** hit "Review and publish" directly.
6. **After** saving the draft, hit "Review and publish".
7. Go back to the [offer's home page](https://partner.microsoft.com/en-us/dashboard/commercial-marketplace/offers/a53ac90b-06f7-4a20-a845-8607ca352e61/overview) and wait for the process to complete before publishing the release.

10
dev-docs/workflows/release.md
View File

@ -86,15 +86,7 @@ Releases should be performed using [the automated release pipeline](https://gith
1. Publish the [provider release](https://github.com/edgelesssys/terraform-provider-constellation/releases)
2. Merge the automated post release PR
3. Write an email to STACKIT to inform them of the new release. For this, you require the name and UUID of the release image. You can find the email address in our internal [wiki](https://github.com/edgelesssys/wiki/blob/master/documentation/constellation/stackit.md):
```shell-session
export OS_CLOUD=stackit
openstack image list | grep constellation
# the output should look similar to this, where the first column is the UUID and the second column is the name
# | 25edf48d-161f-452b-b420-963c3a80abd8 | constellation-stable-v2.16.4-qemu-vtpm | active |
```
3. Publish the [AWS and Azure marketplace images](./marketplace-publishing.md).
4. Close fixed "known issues"
5. Move open issues and PRs from this release's closed milestone to next milestone
6. Reset `UpgradeRequiresIAMMigration` in [`iamupgrade.go`](https://github.com/edgelesssys/constellation/blob/a88a731576184e3c5ee8527741c4a0cdaa4e9b24/cli/internal/cloudcmd/iamupgrade.go#L23).