asc.xhack.course_demoapps role – Deploy the course demo web applications

Note

This role is part of the asc.xhack 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/xhack $HOME/.ansible/collections/ansible_collections/asc/xhack.

To use it in a playbook, specify: asc.xhack.course_demoapps.

Entry point main – Deploy the course demo web applications

New in asc.xhack 1.0.0

Synopsis

  • Deploys the eXtreme Hacking course demo applications as containers on a single VM - deliberately end-of-life PHP/MySQL web apps, a memcached instance and a PhantomJS bot - used for the guided web-exploitation exercises.

Parameters

Parameter

Comments

course_demoapps_build_dir

path

added in asc.xhack 2.0.0

Directory on the VM where the build context and compose project are rendered.

Default: "/opt/demoapps"

course_demoapps_config

dictionary

‘course_demoapps’ role configuration

enabled

boolean

Whether to enable the course_demoapps role

Choices:

  • false ← (default)

  • true

vm_name

string

Name of the VM to deploy

Default: "vmdemoapp01"

vm_size

string

Size of the VM to deploy (Azure VM size)

Default: "Standard_B2as_v2"

course_demoapps_db_image

string

added in asc.xhack 2.0.0

MySQL image for the applications’ database, pinned by digest.

Default: "mysql:5.7@sha256:4bc6bc963e6d8443453676cae56536f4b8156d78bae03c0145cbe47c2aad73bb"

course_demoapps_memcached_image

string

added in asc.xhack 2.0.0

memcached image used by the applications.

Default: "memcached:1.6-alpine"

course_demoapps_phantomjs_base_image

string

added in asc.xhack 2.0.0

Base image for the PhantomJS bot container.

Default: "ubuntu:focal"

course_demoapps_web_image

string

added in asc.xhack 2.0.0

Container image for the PHP web applications. Deliberately end-of-life (PHP 5.6) for the course, pinned by digest.

Default: "php:5.6-apache@sha256:0a40fd273961b99d8afe69a61a68c73c04bc0caa9de384d3b2dd9e7986eec86d"

Authors

  • Ignace De Cock