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

Last updated: 2019-11-21

I want to update my Amazon AppStream 2.0 fleet with a new image. How do I do this? 

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 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