This folder contains everything you will need to build a Windows image with the CircleCI dsc resources, on CircleCI. For more information on setting up VM service, which includes specifying your new Windows image for your users, see our VM service guides for server v3.x and server v2.x.
machine
ExecutorThe following steps will guide you through building a Windows AMI, which you can then specify in the VM Service settings for your installation of CircleCI server, letting users of your installation run their builds in a Windows environment.
Please note that Windows images are built on CircleCI, so we suggest you run through this process once your installation is up and running. Alternatively you can use any other CircleCI account – including on our managed Cloud service.
You can use either AWS or GCP to build your Windows machine image. Choose the one your server instance is running in.
Prerequisites:
Make sure that you have your own copy of this repository on your GitHub organization.
Make sure that you have an access key for an AWS IAM User that has sufficient permission to create AMIs using Packer. Refer to documentation of Packer for details.
First, configure circleci-server-image-builder
context that contains a required AWS access key as env vars. In the context, populate the env vars below:
AWS_ACCESS_KEY_ID
(Access key ID of your access key)AWS_SECRET_ACCESS_KEY
(Secret access key of your access key)AWS_DEFAULT_REGION
(Region where your CircleCI server is hosted, e.g., us-east-1
, us-west-1
, ap-noartheast-1
. Created AMI will be available only for this region.)Our official document would help you setting up contexts.
Create a new project on your CircleCI server to connect your own repo by clicking Set Up Project in the Add Projects page.
After project setup, the first build would run automatically. Wait for it to complete; it would take 2 - 3 hours to finish.
You will find your new Windows AMI ID at the end of the summarize results
step in the job output.
Prerequisites:
Make sure that you have your own copy of this repository on your GitHub organization.
Make sure that you have a JSON-formatted key for a GCP service account that has sufficient permission to create GCE images using Packer. Refer to documentation of Packer for details.
Make sure that the default
network for your working project (which is specified in CLOUDSDK_CORE_PROJECT
as described below) has a firewall rule that allows ingress connections to TCP port 5986 of machines with a packer-winrm
tag.
First, configure circleci-server-image-builder
context that contains credentials for GCE as env vars. In the context, populate the env vars below:
GCE_SERVICE_CREDENTIALS_BASE64
(Base64-encoded service account key; the result of base64 -w 0 your-key-file.json
)CLOUDSDK_CORE_PROJECT
(Name of the project for which the image builder runs and the resulting image is saved)GCE_DEFAULT_ZONE
(Zone where the image builder runs, e.g., us-central1-a
, asia-northeast1-a
.)Our official document would help you setting up contexts.
Create a new project on your CircleCI server to connect your own repo by clicking Set Up Project in the Add Projects page.
After project setup, the first build would run automatically. Wait for it to complete; it would take 2 - 3 hours to finish.
You will find your new Windows image ID at the end of the summarize results
step in the job output.
vpc_id
, subnet_id
(both for AWS) or subnetwork
(for GCP) in windows/visual-studio/packer.yaml
.