asc.core.common role – Shared defaults and helper tasks for the ASC collections
Note
This role is part of the asc.core collection (version 2.0.0).
It is not included in ansible-core.
To check whether it is installed, run ansible-galaxy collection list.
To install it use: git clone git@ssh.dev.azure.com:v3/cloudasc/iac-ansible-collections/core $HOME/.ansible/collections/ansible_collections/asc/core.
To use it in a playbook, specify: asc.core.common.
Entry point add-guac-connection – Add a Guacamole connection for a user
New in asc.core 1.0.0
Synopsis
Add a Guacamole connection for a user
Parameters
Parameter |
Comments |
|---|---|
List of connection groups to add (Terraform resource identifier) |
|
List of connections to add (Terraform resource identifier) |
|
Email address of the target user to add the connection for |
|
Username of the target user to add the connection for |
Authors
Ignace De Cock
Entry point add_winget_source – Register the private ASC WinGet source
New in asc.core 2.0.0
Synopsis
Registers the private WinGet REST source on a Windows host if it is not registered yet.
Parameters
Parameter |
Comments |
|---|---|
Name the private WinGet REST source is registered under. Default: |
|
URL of the private WinGet REST source (Azure Function App). The role default carries the Function App access key, so it is not repeated here. |
Authors
Ignace De Cock
Entry point configure-ssh – Configure SSH connection for Guacamole access
New in asc.core 1.0.0
Synopsis
Configure SSH connection for Guacamole access
Parameters
Parameter |
Comments |
|---|---|
Password of the admin user on the target system |
|
Username of the admin user on the target system |
|
Public key to use for the Guacamole SSH connection |
Authors
Ignace De Cock
Entry point create-ssl-selfsignedcert – Create a self-signed SSL certificate
New in asc.core 1.0.0
Synopsis
Create a self-signed SSL certificate
Parameters
Parameter |
Comments |
|---|---|
Create a PKCS keystore Choices:
|
|
Path to the SSL certificate file |
|
Path to the SSL key file |
|
Common name of the SSL certificate subject |
|
Country name of the SSL certificate subject |
|
Email address of the SSL certificate subject |
|
Organization name of the SSL certificate subject |
Authors
Ignace De Cock
Entry point generate-ssh-keypair – Generate a SSH keypair
New in asc.core 1.0.0
Synopsis
Generate a SSH keypair
Authors
Ignace De Cock
Entry point import-students – Import students from ‘users’ variable
New in asc.core 1.0.0
Synopsis
Import students from ‘users’ variable
Filters the list of users and selects only the ones with the ‘student’ tag
For each user, generate an ID (2 digits, incremental) and store it in the ‘id’ variable
For each user, store the name of the assigned VM in the ‘vm’ variable
Parameters
Parameter |
Comments |
|---|---|
List of users |
Authors
Ignace De Cock
Entry point install_winget_packages – Install WinGet packages from the private ASC WinGet source
New in asc.core 2.0.0
Synopsis
Ensures the WinGet client, registers the private source, prepares the host for unattended installs (SmartScreen, Mark-of-the-Web, Defender exclusions) and imports winget_packages.
Parameters
Parameter |
Comments |
|---|---|
Run the import under an interactive logon (runas) instead of the connection user. Leave it off for MSI installers that hang without a desktop session. Choices:
|
|
When set, links that user’s WinGet packages folder onto their desktop. |
|
Seconds to wait for the import before it is stopped. Default: |
|
Name the private WinGet REST source is registered under. Default: |
|
URL of the private WinGet REST source (Azure Function App). The role default carries the Function App access key, so it is not repeated here. |
|
Packages to install, each with the WinGet package |
|
WinGet package identifier. |
|
Install scope passed to WinGet. Portable (zip) packages ignore their manifest scope and land in the connection user’s profile unless this is Choices:
|
|
Package version to install; the latest when unset. |
Authors
Ignace De Cock
Entry point main – Shared defaults and helper tasks for the ASC collections
New in asc.core 1.0.0
Synopsis
Base role used by every ASC collection. Its task files are invoked individually via
tasks_from(for exampleterraform-configorinstall_winget_packages); running the role directly performs no actions.
Authors
Ignace De Cock
Entry point terraform-config – Render and run the Terraform configuration for a role
New in asc.core 1.0.0
Synopsis
Merges the cross-collection vnet config, renders a role’s
templates/Terraform files intocommon_terraform_dirand drives the plan/apply/destroy lifecycle.
Parameters
Parameter |
Comments |
|---|---|
Run the Choices:
|
|
Regenerate the Terraform configuration files from templates; when Choices:
|
|
Run the Choices:
|
|
Directory holding the Terraform state and the generated configuration files. Default: |
|
Run the Choices:
|
|
Subfolder of a role’s Default: |
Authors
Ignace De Cock