Windows agents and scripts for Google Compute Engine images.
APACHE-2.0 License
This repository stores the collection of Windows packages installed on Google supported Compute Engine images.
Table of Contents
The Windows guest environment is the Google provided configuration and tooling inside of a Google Compute Engine (GCE) virtual machine. The metadata server is a communication channel for transferring information from a client into the guest. The Windows guest environment includes a set of scripts and binaries that read the content of the metadata server to make a virtual machine run properly on Google Compute Engine.
instance_setup.ps1
is configured by GCE sysprep to run on VM first boot.
The script performs the following tasks:
Metadata scripts implement support for running user provided startup scripts and shutdown scripts.
The guest code is packaged in GooGet packages and published to Google Cloud repositories.
We build and install the following packages for the Windows guest environment:
google-compute-engine-sysprep
- Utilities for running sysprep on newgoogle-compute-engine-metadata-scripts
- Windows exe
and cmd
filesgoogle-compute-engine-powershell
- PowerShell module for common functionsgoogle-compute-engine-auto-updater
- Automatic updater for core Googlegoogle-compute-engine-vss
- Google Compute Engine VSS agent and providerThe package build specs are published in this project.
To setup GooGet and install packages run the following commands in an elevated PowerShell prompt:
Download and install GooGet:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Invoke-WebRequest https://github.com/google/googet/releases/download/v2.13.0/googet.exe -OutFile $env:temp\googet.exe
& "$env:temp\googet.exe" -root C:\ProgramData\GooGet -noconfirm install -sources https://packages.cloud.google.com/yuck/repos/google-compute-engine-stable googet
Remove-Item "$env:temp\googet.exe"
On installation GooGet adds content to the system environment, launch a new PowerShell console after installation or provide the full path to googet.exe (C:\ProgramData\GooGet\googet.exe).
Add the google-compute-engine-stable
repo, this must be done in a new console if you just installed GooGet:
googet addrepo google-compute-engine-stable https://packages.cloud.google.com/yuck/repos/google-compute-engine-stable
Install the core packages google-compute-engine-windows
,
google-compute-engine-metadata-scripts
,google-compute-engine-sysprep
,
and google-compute-engine-vss
.
googet -noconfirm install google-compute-engine-windows google-compute-engine-sysprep google-compute-engine-metadata-scripts google-compute-engine-vss
Install optional packages, google-compute-engine-auto-updater
:
googet -noconfirm install google-compute-engine-auto-updater
You can view available packages using the googet available
and installed
packages using the googet installed
command. Running googet update
will
update to the latest versions available. To view additional commands run
googet help
.
Have a patch that will benefit this project? Awesome! Follow these steps to have it accepted.
All files in this repository are under the Apache License, Version 2.0 unless noted otherwise.