@zigbang/appstream v1.1.5-beta.0

Automating AppStream deployments

AppStream은 직방에서 AppStream 관리 및 배포를 위해 만든 툴 입니다. AppStream을 통해 원하는 AppStream의 생성 및 배포를 명령어 하나로 관리할 수 있습니다.

Why create such a thing?

AppStream은 다음 2가지 철학을 근간으로 만들어 졌습니다.

Fully automated and Code-driven

AppStream 이미지를 만들기 위해서는 사람의 손이 너무 많이 가는 문제가 있습니다. 이를 해결하기 위해서는 AppStream 이미지 및 스택을 만드는 프로세스가 모두 자동화가 되어야 하고 코드로 관리가 가능해야 합니다. AppStream을 이용할 경우 간단한 설정 파일 하나로 최신의 운영체제 및 원하는 소프트웨어들을 설치할 수 있고 이를 배포 할 수 있습니다.

직방에서는 여러 형태의 AppStream을 제공해야 합니다. 예를 들어 특정 VPC 안에서 제한된 네트워크로 구동 되어야 하는 경우, 특정 램 이상의 환경으로 구동 되어야 하는 경우, 그래픽 가속이 필요한 경우 등 다양한 케이스들을 설정 파일들로 분리하여 지속적으로 배포하여 운영 하고 있습니다.

Up-to-date

운영체제 및 소프트웨어는 지속적으로 발전하지만 한편으로는 항상 보안의 위협에 놓여 있습니다. AppStream은 성능, 기능 그리고 보안을 고려하여 최신 버전의 소프트웨어를 항상 기본값으로 적용합니다. 물론 특정 버전의 소프트웨어도 지정할 수 있습니다.

직방에서는 AppStream을 이용하여 매일 혹은 필요 시 마다 AppStream을 배포하여 사용하고 있고 배포 시마다 최신 혹은 특정 버전의 운영체제 및 소프트웨어를 적용 합니다.

Getting Started

Prerequisites

• AWS Command Line Interface

Install AppStream

> npm init
> npm install @zigbang/appstream --save-dev

혹은 그냥 global mode로 설치 해도 됩니다.

> npm install -g @zigbang/appstream

Create a config file

아래과 같은 내용으로 chrome.json file 을 만듭니다.

{
	"awsAccessKeyId": "<Your AWS Access Key ID>",
	"awsSecretAccessKey": "<Your AWS Secret Access Key>",
	"awsRegion": "<Your AWS Region>",
	"vpc": "<Your AWS VPC ID>",
	"availabilityZone": "<Your AWS AvailabilityZone>",
	"subnet": "<Your AWS Subnet ID>",
	"cidr": "x.x.x.x/x",
	"keyPair": "<Your AWS EC2 Key Pair>",
	"s3BucketUrl": "<Your AWS S3 Bucket URL>",
	"imageBuilderName": "zigbang-Chrome",
	"imageName": "zigbang-Chrome",
	"fleetName": "zigbang-Chrome",
	"stackName": "zigbang-chrome",
	"instanceType": "stream.standard.medium",
	"applications": [
		{
			"id": "Chrome",
			"packageName": "googlechrome",
			"path": "C:\\\"Program Files\"\\Google\\Chrome\\Application\\chrome.exe",
			"displayName": "Chrome"
		}
	]
}

Create an AppStream

> npx appstream deploy ./chrome.json

또는

> npx -p @zigbang/appstream appstream deploy ./chrome.json

Delete an AppStream

> npx appstream destroy ./chrome.json

Configuration

Root

Tag

Application

Image Assistant CLI의 상세한 옵션은 다음 URL을 참고 하세요.

• https://docs.aws.amazon.com/appstream2/latest/developerguide/programmatically-create-image.html

Scripts

How It Works Internally

AppStream의 자동화는 Image Builder Windows에서의 Remote Management (WinRM)에 의존성이 높습니다. 이미 AWS에서 제공하는 많은 글들을 통해 Image Builder가 특정 전제 조건을 만족할 경우 원격으로 명령어를 실행하여 자동화하는 방법을 제공하고 있습니다.

• How to use SSM Run to perform programmatic actions on AppStream 2.0 image builders

전제 조건중 가장 중요한 부분은 Image Builder가 원격으로 명령을 받을 수 있는 환경이어야 한다는 점 입니다. 다만 대부분의 가이드는 Image Builder에 사람이 접속을 하여 활성화를 해줘야 한다는 점에서 사람의 개입이 있을 수 밖에 없어서 완전 자동화를 이룰 수 없는 한계점이 있습니다.

이를 해결하기 위해서 AppStream은 사전에 Active Directory를 하나 생성합니다. 이 Active Directory의 역할은 Image Builder로 하여금 원격 명령을 받을 수 있는 정책을 내려주는 역할을 합니다. 그게 다입니다! 이를 통해 Image Builder는 도메인에 조인을 하고 GPO를 통해 원격 명령을 받을 수 있는 정책을 내려 받고 이후 Image Builder는 원격 명령을 내릴 수 있는 상태로 변경이 됩니다. 이 다음부터는 여러분들의 상상에 의해 자유롭게 Image Builder를 통해 원하는 이미지 생성을 하면 됩니다.

AppStream이 구동되는 전체적인 workflow는 다음과 같습니다.

1. Active Directory를 생성
   • WinRM 설정을 내려주는 GPO를 생성
2. Image Builder 생성 및 위에서 생성된 AD에 조인
3. Image Builder에 필요한 소프트웨어 설치 및 설정
4. Image 생성
   • 항상 최신 agent를 적용
5. Fleet, stack 및 streaming URL 생성
6. Clean up resources