Class: Ansible::Ruby::Modules::Apt

Inherits:
Base show all
Defined in:
lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb

Instance Method Summary collapse

Methods inherited from Base

#ansible_name, #to_h

Methods inherited from Ansible::Ruby::Models::Base

attr_option, attr_options, attribute, #initialize, #to_h, validates

Constructor Details

This class inherits a constructor from Ansible::Ruby::Models::Base

Instance Method Details

#allow_unauthenticated ⇒ :yes, ...

Returns Ignore if packages cannot be authenticated. This is useful for bootstrapping environments that manage their own apt-key setup.

Returns:

  • (:yes, :no, nil) —

    Ignore if packages cannot be authenticated. This is useful for bootstrapping environments that manage their own apt-key setup.



42
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 42

attribute :allow_unauthenticated

#autoremove ⇒ Boolean?

Returns If C(yes), remove unused dependency packages for all module states except I(build-dep).

Returns:

  • (Boolean, nil) —

    If C(yes), remove unused dependency packages for all module states except I(build-dep).



58
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 58

attribute :autoremove

#cache_valid_time ⇒ Boolean?

Returns If C(update_cache) is specified and the last run is less or equal than I(cache_valid_time) seconds ago, the C(update_cache) gets skipped.

Returns:

  • (Boolean, nil) —

    If C(update_cache) is specified and the last run is less or equal than I(cache_valid_time) seconds ago, the C(update_cache) gets skipped.



22
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 22

attribute :cache_valid_time

#deb ⇒ String?

Returns Path to a .deb package on the remote machine.,If :// in the path, ansible will attempt to download deb before installing. (Version added 2.1).

Returns:

  • (String, nil) —

    Path to a .deb package on the remote machine.,If :// in the path, ansible will attempt to download deb before installing. (Version added 2.1)



54
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 54

attribute :deb

#default_release ⇒ String?

Returns Corresponds to the C(-t) option for I(apt) and sets pin priorities.

Returns:

  • (String, nil) —

    Corresponds to the C(-t) option for I(apt) and sets pin priorities



30
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 30

attribute :default_release

#dpkg_options ⇒ Array<String>, ...

Returns Add dpkg options to apt command. Defaults to ‘-o “Dpkg::Options::=–force-confdef” -o “Dpkg::Options::=–force-confold”’,Options should be supplied as comma separated list.

Returns:

  • (Array<String>, String, nil) —

    Add dpkg options to apt command. Defaults to ‘-o “Dpkg::Options::=–force-confdef” -o “Dpkg::Options::=–force-confold”’,Options should be supplied as comma separated list



50
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 50

attribute :dpkg_options

#force ⇒ :yes, ...

Returns If C(yes), force installs/removes.

Returns:

  • (:yes, :no, nil) —

    If C(yes), force installs/removes.



38
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 38

attribute :force

#install_recommends ⇒ :yes, ...

Returns Corresponds to the C(–no-install-recommends) option for I(apt). C(yes) installs recommended packages. C(no) does not install recommended packages. By default, Ansible will use the same defaults as the operating system. Suggested packages are never installed.

Returns:

  • (:yes, :no, nil) —

    Corresponds to the C(–no-install-recommends) option for I(apt). C(yes) installs recommended packages. C(no) does not install recommended packages. By default, Ansible will use the same defaults as the operating system. Suggested packages are never installed.



34
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 34

attribute :install_recommends

#name ⇒ String?

Returns A package name, like C(foo), or package specifier with version, like C(foo=1.0). Name wildcards (fnmatch) like C(apt*) and version wildcards like C(foo=1.0*) are also supported. Note that the apt-get commandline supports implicit regex matches here but we do not because it can let typos through easier (If you typo C(foo) as C(fo) apt-get would install packages that have “fo” in their name with a warning and a prompt for the user. Since we don’t have warnings and prompts before installing we disallow this. Use an explicit fnmatch pattern if you want wildcarding).

Returns:

  • (String, nil) —

    A package name, like C(foo), or package specifier with version, like C(foo=1.0). Name wildcards (fnmatch) like C(apt*) and version wildcards like C(foo=1.0*) are also supported. Note that the apt-get commandline supports implicit regex matches here but we do not because it can let typos through easier (If you typo C(foo) as C(fo) apt-get would install packages that have “fo” in their name with a warning and a prompt for the user. Since we don’t have warnings and prompts before installing we disallow this. Use an explicit fnmatch pattern if you want wildcarding)



10
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 10

attribute :name

#only_upgrade ⇒ Boolean?

Returns Only install/upgrade a package if it is already installed.

Returns:

  • (Boolean, nil) —

    Only install/upgrade a package if it is already installed.



62
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 62

attribute :only_upgrade

#purge ⇒ Boolean?

Returns Will force purging of configuration files if the module state is set to I(absent).

Returns:

  • (Boolean, nil) —

    Will force purging of configuration files if the module state is set to I(absent).



26
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 26

attribute :purge

#state ⇒ :latest, ...

Returns Indicates the desired package state. C(latest) ensures that the latest version is installed. C(build-dep) ensures the package build dependencies are installed.

Returns:

  • (:latest, :absent, :present, :"build-dep", nil) —

    Indicates the desired package state. C(latest) ensures that the latest version is installed. C(build-dep) ensures the package build dependencies are installed.



14
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 14

attribute :state

#update_cache ⇒ Boolean?

Returns Run the equivalent of C(apt-get update) before the operation. Can be run as part of the package installation or as a separate step.

Returns:

  • (Boolean, nil) —

    Run the equivalent of C(apt-get update) before the operation. Can be run as part of the package installation or as a separate step.



18
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 18

attribute :update_cache

#upgrade ⇒ :no, ...

Returns If yes or safe, performs an aptitude safe-upgrade.,If full, performs an aptitude full-upgrade.,If dist, performs an apt-get dist-upgrade.,Note: This does not upgrade a specific package, use state=latest for that.

Returns:

  • (:no, :yes, :safe, :full, :dist, nil) —

    If yes or safe, performs an aptitude safe-upgrade.,If full, performs an aptitude full-upgrade.,If dist, performs an apt-get dist-upgrade.,Note: This does not upgrade a specific package, use state=latest for that.



46
 
# File 'lib/ansible/ruby/modules/generated/core/packaging/os/apt.rb', line 46

attribute :upgrade