Getting Started / Hands-on / ...

Module 6. Test your setup

In this module, you test the experience for AppStream 2.0 enterprise application onboarding. To do so, browse to the Example Corp. Enterprise Application Onboarding Portal, and complete the registration form. If this process is successful, you are redirected to a topic in the AppStream 2.0 technical documentation, and you receive an email that describes next steps for application onboarding.

Customize the FROM address used for email communications with your users

Build a serverless back end

Create a state machine

Deploy a RESTful API

Host a static website

Test your setup

Implementation instructions

Follow the step-by-step instructions below to test your setup.

  • Step 1. Test your setup

    Test your setup

     1. Open a web browser, and in the address bar, type the endpoint URL that was generated when you completed the steps in “Enable static website hosting for your Amazon S3 bucket.” Follow this format: http://YOUR-S3-ENDPOINT-URL/

     2. Do the following to complete the onboarding form for AppStream 2.0 enterprise application onboarding:

          • Enter in First Name, Last Name and Email to an e-mail box you have access to.

          • For Email, type the email address that was added and verified when you completed the steps in “Add and verify a new email address identity in Amazon SES.”

          • For Department Code, type a unique identifier. This ID is appended to the end of the names of the AppStream 2.0 resources that are created.

          • Choose Start.

     3. If the request is successful, within a few seconds you are redirected to the following topic in the AppStream 2.0 technical documentation: Create a Custom AppStream 2.0 Image by Using the AppStream 2.0 Console

     4. During this time, an AppStream 2.0 image builder is also created. To confirm that the image builder was created, do the following:

          • Open the AppStream 2.0 console.

          • In the navigation pane, choose Images.

          • On the Image Builder tab, the name for the image builder that is created for you is based on the first name that you entered when you signed up for enterprise application onboarding, and the department code.

                ° For example, for a user who entered Jane as the first name and EAO as the department code, the name of the image that is created is JaneEAO.

                ° Within 30 minutes, you receive an e-mail that includes a link to connect to the image builder that is provisioned. The email subject line and body are as follows:

                ° Email subject line: Example Corp Enterprise Application Onboarding for

                ° Email body:

                ° <FirstName>

                ° Thank you for trying out the Example Corp Enterprise Application Onboarding demo. If this is your first time installing your application with AppStream2.0, you can check the getting started guide below for assistance. Otherwise, please click the connect link below to get started.

                ° Connect <This link is a streaming URL that lets you connect to the image builder that was provisioned when you signed up for application onboarding>

                ° Getting Started Guide

     5. Click the Connect link, log onto the image builder as Administrator, and run Image Assistant to create an image. For information about how to create an image, see Tutorial: Create a Custom AppStream 2.0 Image by Using the AppStream 2.0 Console.

     6. After you create your image, a fleet is created automatically based on the new image. Also, you receive a second e-mail that includes a link that lets you connect to a fleet instance for verification. The email subject line and body are as follows:

          • Email subject line: Example Corp Enterprise Application Onboarding for

          • Email body:

          • <FirstName>,

          • Thank you for trying out the Example Corp Enterprise Application Onboarding demo. Your fleet is now created and ready for verification. Please use the connect link below to connect to the instance.

          • Connect< This link is a streaming URL that lets you connect to the fleet instance that was provisioned automatically after you created your image>

          • Getting Started Guide

     7. Choose the Connect link to connect to the fleet instance and start an AppStream 2.0 streaming session.

     8. After you receive the e-mail regarding the fleet, you will have one hour until the Step Functions state machine that you created invokes the StopResources Lambda function which will stop your fleet. This is done to control costs.

  • Step 2. Cleaning up your resources.

    Follow the step-by-step instructions below to clean up your project resources. Click on each step number to expand the section.

    Step 1. Delete your Amazon S3 bucket

    Complete the following steps to delete your Amazon S3 bucket by using the Amazon S3 console.

    1. Open the Amazon S3 console at https://console.aws.amazon.com/s3/.
    2. In the S3 buckets list, select the check box next to the name of the bucket that you created for this project. If the list contains many Amazon S3 buckets, type the name of the bucket in the search box to find it.
    3. In a pane that displays the settings for Properties, Permissions, and Management settings, choose the X icon in the upper right of the pane to close it.
    4. Choose Delete.
    5. In the confirmation dialog box, type the name of the bucket, and choose Confirm.

    Step 2. Delete your verified email identity

    1. Open the Amazon SES console at https://console.aws.amazon.com/ses/.
    2. In the navigation pane, under Identity Management, choose Email Addresses.
    3. In the Email Address Identities list, select the check box next to the email address that you want to delete, and then choose Remove.
      If the list contains many email addresses, type the name of the email address in the search box to find it.
    4. In the confirmation dialog box, choose Yes, Delete Identity.
    Step 3. Delete your Lambda functions
    1. Open the AWS Lambda console at https://console.aws.amazon.com/lambda/.
    2. In the Functions list, select the option next to examplecorp_eao_createimagebuilder.
      • If the list contains many functions, type the name of this function in the search box to find it.
    3. Choose Actions, Delete.
    4. In the confirmation dialog box, choose Delete.
      Do steps 1-4 for the following Functions. 
      • examplecorp_eao_getstatus
      • examplecorp_eao_sendstreamingurl
      • examplecorp_eao_getimagename
      • examplecorp_eao_createfleet
      • examplecorp_eao_stopresources

    Step 4. Delete your IAM role

    1. Open the IAM console at https://console.aws.amazon.com/iam/.
    2. In the navigation pane, choose Roles.
    3. In the roles list, select the check box next to examplecorp_eao_role.
      • If the list contains many roles, type the name of this role in the search box to locate it.
    4. Choose Delete role.
    5. In the confirmation dialog box, choose Yes, Delete
    Step 5. Delete your IAM policy
    1. Open the IAM console at https://console.aws.amazon.com/iam/.
    2. In the navigation pane, choose Policies.
    3. In the policies list, select the option button next to examplecorp_lambda_tin_policy.
      • If the list contains many policies, type the name of this policy in the search box to locate it.
    4. Choose Policy actions, Delete.
    5. In the confirmation dialog box, choose Delete.

    Step 6. Delete your RESTful API

    1. Open the Amazon API Gateway console at https://console.aws.amazon.com/apigateway.
    2. In the navigation pane, under APIs, choose examplecorp_eao.
    3. Choose Actions, Delete API.
    4. In the confirmation dialog box, choose Delete.

    Step 7. Delete your Step Functions State Machine

    1. Open the Step Functions console at https://console.aws.amazon.com/states.
    2. In the navigation pane, under State machines, choose examplecorp_eao.
    3. With examplecorp_eao selected, choose Delete
    4. Choose Delete state machine on the confirmation dialog box.
    Step 8. Stop and delete your AppStream 2.0 image builder
    1. Open the AppStream 2.0 console at https://console.aws.amazon.com/appstream2.
    2. In the navigation pane, choose Images, Image Builder tab.
    3. Confirm whether the image builder created, named <firstname><dept code>_IB is in a stopped state. If not, select the image builder and choose Actions, Stop.
    4. After the image builder has stopped, choose Actions, Delete.

    Step 9. Disassociate your AppStream 2.0 fleet from your stack and delete your stack

    1. In the AppStream 2.0 console, in the navigation pane, choose Stacks.
    2. Select the stack created, named <dept code>_Stack and choose Actions, Disassociate Fleet. This action disassociates the fleet from the stack.
    3. To delete the stack, choose Actions, Delete.

    Step 10. Stop and delete your fleet

    1. In the AppStream 2.0 console, in the navigation pane, choose Fleets.
    2. Confirm whether the fleet created, named <dept code>_Fleet is in a stopped state. If not, select the fleet and choose Actions, Stop.
    3. After the fleet has stopped, choose Actions, Delete.

Congratulations, you have successfully deployed the Example Corp. enterprise application onboarding portal which enables application owners to self-service install and stream AppStream 2.0 applications.