Repository files navigation

This repository stores the collection of Windows packages installed on Googlesupported Compute Engineimages.

Table of Contents

• Background
• Agent
  • Configuring
  • Account Setup
  • IP Forwarding
  • Windows Failover Cluster Support
• Instance Setup
• Metadata Scripts
• Packaging and Package Distribution
• Contributing
• License

The Windows guest environment is the Google provided configuration andtooling inside of aGoogle Compute Engine(GCE) virtual machine. Themetadata server is acommunication channel for transferring information from a client into the guest.The Windows guest environment includes a set of scripts and binaries that readthe content of the metadata server to make a virtual machine run properly onGoogle Compute Engine.

instance_setup.ps1 is configured by GCE sysprep to run on VM first boot.The script performs the following tasks:

• Set the hostname to the instance name.
• Runs user provided 'specialize' startup script.
• Activates Windows using a KMS server.
• Sets up RDP and WinRM to allow remote login.

Metadata scripts implement support for running user providedstartup scripts andshutdown scripts.

The guest code is packaged inGooGetpackages 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 newWindows virtual machines.
• google-compute-engine-metadata-scripts - Windowsexe andcmd filesto run startup and shutdown scripts.
• google-compute-engine-powershell - PowerShell module for common functionsused by other packages.
• google-compute-engine-auto-updater - Automatic updater for core Googlepackages.
• google-compute-engine-vss - Google Compute Engine VSS agent and provider

The package build specs are published in this project.

To setup GooGet and install packages run the following commands in an elevatedPowerShell prompt:

Download and install GooGet:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12Invoke-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 googetRemove-Item "$env:temp\googet.exe"

On installation GooGet adds content to the system environment, launch a new PowerShellconsole after installation or provide the full path to googet.exe(C:\ProgramData\GooGet\googet.exe).

Add thegoogle-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 packagesgoogle-compute-engine-windows,google-compute-engine-metadata-scripts,google-compute-engine-sysprep,andgoogle-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 thegooget available and installedpackages using thegooget installed command. Runninggooget update willupdate to the latest versions available. To view additional commands rungooget help.

Have a patch that will benefit this project? Awesome! Follow these steps to haveit accepted.

1. Please sign ourContributor License Agreement.
2. Fork this Git repository and make your changes.
3. Create a Pull Request.
4. Incorporate review feedback to your changes.
5. Accepted!

All files in this repository are under theApache License, Version 2.0 unless noted otherwise.