theforeman.foreman.foreman_templates_import (0.8.1) — module

Sync templates from a repository

Authors: Anton Nesterov (@nesanton)

preview | supported by community

Install collection

Install with ansible-galaxy collection install theforeman.foreman:==0.8.1


Add to requirements.yml

  collections:
    - name: theforeman.foreman
      version: 0.8.1

Description

Sync provisioning templates, report_templates, partition tables and job templates from external git repository or file system.

Based on foreman_templates plugin U(https://github.com/theforeman/foreman_templates).


Requirements

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: Sync templates from git repo
  foreman_templates_import:
    repo: https://github.com/theforeman/community-templates.git
    branch: 1.24-stable
    associate: new
    server_url: "https://foreman.example.com"
    username: "admin"
    password: "changeme"

Inputs

    
lock:
    description:
    - Lock imported templates.
    required: false
    type: bool

repo:
    description:
    - Filesystem path or repo (with protocol), for example /tmp/dir or git://example.com/repo.git
      or https://example.com/repo.git.
    required: false
    type: str

force:
    description:
    - Update templates that are locked.
    required: false
    type: bool

branch:
    description:
    - Branch of the I(repo). Only for git-based repositories.
    required: false
    type: str

filter:
    description:
    - Sync only templates with name matching this regular expression, after I(prefix)
      was applied.
    - Case-insensitive, snippets are not filtered.
    required: false
    type: str

negate:
    description:
    - Negate the filter condition.
    required: false
    type: bool

prefix:
    description:
    - Adds specified string to beginning of all imported templates that do not yet have
      that prefix.
    required: false
    type: str

dirname:
    description:
    - The directory within Git repo containing the templates.
    required: false
    type: str

verbose:
    description:
    - Add template reports to the output.
    required: false
    type: bool

password:
    description: Password of the user accessing the Foreman server
    required: true
    type: str

username:
    description: Username accessing the Foreman server
    required: true
    type: str

associate:
    choices:
    - always
    - new
    - never
    description:
    - Associate to Operatingsystems, Locations and Organizations based on metadata.
    required: false
    type: str

locations:
    description: List of locations the entity should be assigned to
    elements: str
    type: list

server_url:
    description: URL of the Foreman server
    required: true
    type: str

organizations:
    description: List of organizations the entity should be assigned to
    elements: str
    type: list

validate_certs:
    aliases:
    - verify_ssl
    default: true
    description: Whether or not to verify the TLS certificates of the Foreman server
    type: bool