ansible tower user guide - ansible continuous integration / continuous deployment ... for a...

Download Ansible Tower User Guide - Ansible   Continuous integration / Continuous Deployment ... for a systems management application, ... Ansible Tower User Guide, Release Ansible

Post on 15-May-2018

252 views

Category:

Documents

8 download

Embed Size (px)

TRANSCRIPT

  • Ansible Tower User GuideRelease Ansible Tower 2.4.3

    Red Hat, Inc.

    Jun 06, 2017

  • CONTENTS

    1 Overview 21.1 Real-time Playbook Output and Exploration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21.2 Push Button Automation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21.3 Role Based Access Control and Auditing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21.4 Cloud & Autoscaling Flexibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21.5 The Ideal RESTful API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.6 Backup and Restore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.7 Ansible Galaxy Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.8 Inventory Support for OpenStack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.9 Remote Command Execution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31.10 System Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

    2 Tower Licensing, Updates, and Support 42.1 Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42.2 Trial Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42.3 License Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42.4 License Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52.5 Tower Component Licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

    3 Logging In 7

    4 Exploring the Dashboard and Tower Interface 84.1 Tower User Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84.2 Setup Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94.3 Portal Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104.4 The Dashboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.5 Activity Streams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13

    5 Organizations 145.1 Organizations - Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165.2 Organization - Administrators . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

    6 Users 206.1 Users - Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 226.2 Users - Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 246.3 Users - Admin of Organizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266.4 Users - Organizations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 266.5 Users - Teams . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

    7 Teams 287.1 Teams - Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

    i

  • 7.2 Teams - Permissions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 307.3 Teams - Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337.4 Teams - Users . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34

    8 Credentials 368.1 Understanding How Credentials Work . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368.2 Getting Started with Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368.3 Add a New Credential . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 378.4 Credential Types . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38

    9 Projects 479.1 Add a new project . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489.2 Updating projects from source control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 509.3 Ansible Galaxy Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 529.4 Add a new schedule . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52

    10 Inventories 5410.1 Add a new inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5510.2 Scan Job Templates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5610.3 Groups and Hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6210.4 Running Ad Hoc Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7610.5 System Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78

    11 Job Templates 8411.1 Utilitzing Cloud Credentials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8711.2 Surveys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8811.3 Provisioning Callbacks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9111.4 Launching Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9311.5 Scheduling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94

    12 Jobs 9712.1 Job Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9712.2 Job Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9912.3 Job Concurrency . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102

    13 Best Practices 10413.1 Use Source Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10413.2 Ansible file and directory structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10413.3 Use Dynamic Inventory Sources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10413.4 Variable Management for Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10513.5 Autoscaling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10513.6 Larger Host Counts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10513.7 Continuous integration / Continuous Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105

    14 Security 10614.1 Playbook Access and Information Sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10614.2 Role-Based Access Controls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

    15 Index 112

    Index 113

    ii

  • Ansible Tower User Guide, Release Ansible Tower 2.4.3

    Thank you for your interest in Ansible Tower, the open source IT orchestration engine. Whether sharing operationstasks with your team or integrating with Ansible through the Tower REST API, Tower provides many powerful toolsto make your automation life easier.

    The Ansible Tower User Guide discusses all of the functionality available in Ansible Tower and assumes moderatefamiliarity with Ansible, including concepts such as Playbooks, Variables, and Tags. For more information on theseand other Ansible concepts, please see the Ansible documentation at http://docs.ansible.com/. This document has beenupdated to include information for the latest release of Ansible Tower 2.4.3.

    Ansible Tower Version 2.4.3; December 18, 2015; https://access.redhat.com/

    CONTENTS 1

    http://docs.ansible.com/https://access.redhat.com/

  • CHAPTER

    ONE

    OVERVIEW

    Thank you for your interest in Ansible Tower. Tower is a graphically-enabled framework accessible via a web interfaceand a REST API endpoint for Ansible, the open source IT orchestration engine. Whether sharing operations tasks withyour team or integrating with Ansible through the Tower REST API, Tower provides many powerful tools to makeyour automation life easier.

    1.1 Real-time Playbook Output and Exploration

    Watch playbooks run in real time, seeing each host as they check in. Easily go back and explore the results for specifictasks and hosts in great detail. Search for specific plays or hosts and see just those results, or quickly zero in on errorsthat need to be corrected.

    1.2 Push Button Automation

    Access your favorite projects and re-trigger execution from the web interface with a minimum of clicking. Tower willask for input variables, prompt for your credentials, kick off and monitor the job, and display results and host historyover time.

    1.3 Role Based Access Control and Auditing

    Ansible Tower allows delegating specific authority to different teams or explicit users. Keep some projects private.Allow some users to edit inventory and others to run playbooks against only certain systemseither in check (dry run)or live mode. Allow certain users to use credentials without exposing the credentials to them. Regardless of what youdo, tower records the history of operations and who made themincluding objects edited and jobs launched.

    1.4 Cloud & Autoscaling Flexibility

    Tower features a powerful provisioning callback feature that allows nodes to request configuration o

Recommended

View more >