How do I update the image of an existing Amazon AppStream 2.0 fleet?

Resolution

You can update a running fleet with a new image using the AppStream 2.0 console or the AWS Command Line Interface (AWS CLI).

Note: Updating the image doesn't disrupt users who are connected to an active streaming session. The streaming instance is terminated after the streaming session is finished. Any new streaming instances use the updated image. All existing fleet instances must be exhausted before new sessions begin to launch with the updated image. To rapidly push the new image to all new sessions, you must stop and start the fleet. For more information, see Update an AppStream 2.0 fleet with a new image.

Use the AppStream 2.0 console

1. Open the AppStream 2.0 console, and then choose Fleets from the navigation pane.
2. Select the fleet that you want to update.
3. For Actions, choose Edit.
4. For Name, choose the new image.
5. Choose Update Fleet.

Use the AWS CLI

Note: If you receive errors when running AWS CLI commands, make sure that you’re using the most recent version of the AWS CLI.

For public and private images, enter the following command, replacing ExampleImage and ExampleFleet with your values:

aws appstream update-fleet --image-name ExampleImage --name ExampleFleet

Shared images require the image-arn parameter. For shared images, use the following command, replacing arn:aws:appstream:us-east-1:123456789012:image/ExampleImage and ExampleFleet with your values:

aws appstream update-fleet --image-arn  arn:aws:appstream:us-east-1:123456789012:image/ExampleImage --name ExampleFleet

Related information

What is Amazon AppStream 2.0?

Fleets and stacks

Using the AWS CLI

Fleet Auto Scaling for Amazon AppStream 2.0