Amazon DCV Samples
Welcome to the DCV Samples repository within AWS Samples. This repository will be used to host samples for Amazon DCV integrated workloads. These workloads include managed services that leverage DCV, such as Amazon WorkSpaces that stream with DCV (previously known as WSP).
Glossary
Overview
Bootstrap
The provided script dcv-gateway-installer.sh bootstraps the installation and configuration of the DCV Connection Gateway component. This can be injected with Amazon EC2 user data or by running the script locally with sudo. To read more about the DCV Connection Gateway, see the DCV Connection Gateway Administrator Guide.
The provided script dcv-session-manager-installer.sh bootstraps the installation and configuration of the DCV Session Manager component. This can be injected with Amazon EC2 user data or by running the script locally with sudo. To read more about DCV Session Manager, see the DCV Session Manager Administrator Guide.
The provided script Install-DCVandSMAgent.ps1 bootstraps the installation and configuration of DCV server and DCV Session Manager agent. This can be injected with Amazon EC2 user data or by running the script locally within an Administrator PowerShell terminal. Updating the SESSION-MGR-PRIVATE-DNS placeholder with the private DNS of DCV Session Manager allows the script to configure the host correctly.
The provided script Install-DCV.ps1 bootstraps the installation and configuration of only DCV server. This can be invoked by injecting with Amazon EC2 user data or by running the script locally within an Administrator PowerShell terminal. Optionally parameters are commented out to configure automatic session creations.
The provided script linux-config-sessionmgr-agent.sh bootstraps the configuration of DCV server and DCV Session Manager agent. This can be injected with Amazon EC2 user data or by running the script locally with sudo. Updating the SESSION-MGR-PRIVATE-DNS placeholder with the private DNS of DCV Session Manager allows the script to configure the host correctly. Note, this script will only work on a host that already has DCV server and DCV Session Manager agent installed. It is intended to be used with the Linux-based AWS Marketplace DCV AMIs.
CDK
This folder contains several AWS Cloud Development Kit (AWS CDK) examples for deploying DCV workloads as IaaC. For an overview of the current CDK examples, see the README in the cdk folder.
Current CDK Examples
- Deploy an EC2 Mac image automation pipeline using AWS Step Functions
- Deploy a DCV Session Manager and DCV Connection Gateway environment
- Deploy a DCV Session Manager and DCV Connection Gateway environment with EC2 Image Builder pipelines for both components
- Deploy DCV Access Console
Session Resolver
The provided script provides logic to run in a AWS Lambda function to resolver DCV sessions streaming through a DCV Connection Gateway. To learn more, see the Build a serverless session resolver for your Amazon DCV Connection Gateway AWS blog post.
DCV Usage Reports
The provided scripts to generate DCV usage reports on Windows illustrate how to use DCV calls to find when a user starts and ends their session. This allows administrators to generate granular usage reports that can be further modified to include additional information. For a walkthrough of how to implement these reports on a DCV Amazon WorkSpace, see this blog post. Note, for WorkSpaces using DCV, utilize the WSP PowerShell script.
Security
See CONTRIBUTING for more information.
License
This library is licensed under the MIT-0 License. See the LICENSE file.