NAME

       cdist-type__package_apt - Manage packages with apt-get

DESCRIPTION

       apt-get  is  usually  used  on  Debian  and variants (like Ubuntu) to manage packages. The
       package will be installed without recommended or suggested packages. If such packages  are
       required, install them separatly or use the parameter --install-recommends.

       This  type  will  also update package index, if it is older than one day, to avoid missing
       package error messages.

REQUIRED PARAMETERS

       None

OPTIONAL PARAMETERS

       name   If supplied, use the name and not the object id as the package name.

       state  Either "present" or "absent", defaults to "present"

       target-release
              Passed on to apt-get install, see apt-get(8).  Essentially allows you  to  retrieve
              packages from a different release

       version
              The  version of the package to install. Default is to install the version chosen by
              the local package manager.

BOOLEAN PARAMETERS

       install-recommends
              If the package will be installed, it also installs recommended packages with it. It
              will not install recommended packages if the original package is already installed.

              In  most  cases,  it  is  recommended  to install recommended packages separatly to
              control which additional packages will be  installed  to  avoid  useless  installed
              packages.

       purge-if-absent
              If  this  parameter  is  given when state is absent, the package is purged from the
              system (using --purge).

EXAMPLES

          # Ensure zsh in installed
          __package_apt zsh --state present

          # In case you only want *a* webserver, but don't care which one
          __package_apt webserver --state present --name nginx

          # Remove obsolete package
          __package_apt puppet --state absent

SEE ALSO

       cdist-type__package(7)

AUTHORS

       Nico Schottelius <nico-cdist--@--schottelius.org>

COPYING

       Copyright (C) 2011-2012 Nico Schottelius. You can redistribute it and/or modify  it  under
       the  terms of the GNU General Public License as published by the Free Software Foundation,
       either version 3 of the License, or (at your option) any later version.

COPYRIGHT

       ungleich GmbH 2020