Create a build with a container image#

Refer to Container builds to learn more.

1. In the Unity Cloud Dashboard, open Game Server Hosting (Multiplay).

2. Select Builds > Create build.

3. Fill in the build details:

   1. Give the new build a name.
   2. Select the operating system.
   3. As the Upload method, select Container image.

4. Select Next to continue to the Service account step.

5. To add your container image to the Game Server Hosting registry, you’ll need a service account. Follow the below instructions:

   1. Go to the Service accounts page and create a new service account. If you already have a service account, continue to the next step
   2. In the Keys section of your service account, create a new key and store both the Key ID and the Secret key somewhere safe.
   3. Within the Project roles section of your service account, add the Game Server Hosting Registry Editor role.

6. Select Next to continue to the Add to registry step.

7. Complete the following instructions to add your container image to the Game Server Hosting registry. Note that the Create build window provides you with the required IDs.

   1. Give the new build a version name or leave empty to give this update a version name automatically. The automatic version name is the creation time of the build.
   2. Log into the Game Server Hosting container registry with your service account. Use your Key ID for the username and your Secret Key for the password: docker login registry.multiplay.com -u <KeyID> -p <SecretKey>
   3. Tag your container image with the following line: docker tag <ImageName>:<ImageTag> registry.multiplay.com/<project_id>/<environment_id>/<build_id>:<version>
   4. Push your container image to the Game Server Hosting registry: docker push registry.multiplay.com/<project_id>/<environment_id>/<build_id>:<version>

8. Select Next to continue to the Select image step.

9. Choose the method by which you want to select your image.

   1. Set Container image to your image.
   2. Select the rollout mode. You can perform a progressive rollout or a forced rollout.

You now have a new build. Before you can use the build, you need to create (and link) a build configuration and a fleet. Refer to Create a build configuration.