REFERENCE.md

   1 # Reference
   2 <!-- DO NOT EDIT: This document was generated by Puppet Strings -->
   3
   4 ## Table of Contents
   5
   6 **Classes**
   7
   8 _Public Classes_
   9
  10 * [`apt`](#apt): Main class, includes all other classes.
  11 * [`apt::backports`](#aptbackports): Manages backports.
  12
  13 _Private Classes_
  14
  15 * `apt::params`: Provides defaults for the Apt module parameters.
  16 * `apt::update`: Updates the list of available packages using apt-get update.
  17
  18 **Defined types**
  19
  20 * [`apt::conf`](#aptconf): Specifies a custom Apt configuration file.
  21 * [`apt::key`](#aptkey): Manages the GPG keys that Apt uses to authenticate packages.
  22 * [`apt::mark`](#aptmark): defined typeapt::mark
  23 * [`apt::pin`](#aptpin): Manages Apt pins. Does not trigger an apt-get update run.
  24 * [`apt::ppa`](#aptppa): Manages PPA repositories using `add-apt-repository`. Not supported on Debian.
  25 * [`apt::setting`](#aptsetting): Manages Apt configuration files.
  26 * [`apt::source`](#aptsource): Manages the Apt sources in /etc/apt/sources.list.d/.
  27
  28 **Resource types**
  29
  30 _Public Resource types_
  31
  32
  33 _Private Resource types_
  34
  35 * `apt_key`: This type provides Puppet with the capabilities to manage GPG keys needed
  36 by apt to perform package validation. Apt has it's own GPG keyring that can
  37 be manipulated through the `apt-key` command.
  38
  39 **Data types**
  40
  41 * [`Apt::Auth_conf_entry`](#aptauth_conf_entry): Login configuration settings that are recorded in the file `/etc/apt/auth.conf`.
  42 * [`Apt::Proxy`](#aptproxy): Configures Apt to connect to a proxy server.
  43
  44 **Tasks**
  45
  46 * [`init`](#init): Allows you to perform apt functions
  47
  48 ## Classes
  49
  50 ### apt
  51
  52 Main class, includes all other classes.
  53
  54 * **See also**
  55 https://docs.puppetlabs.com/references/latest/function.html#createresources
  56 for the create resource function
  57
  58 #### Parameters
  59
  60 The following parameters are available in the `apt` class.
  61
  62 ##### `provider`
  63
  64 Data type: `String`
  65
  66 Specifies the provider that should be used by apt::update.
  67
  68 Default value: $apt::params::provider
  69
  70 ##### `keyserver`
  71
  72 Data type: `String`
  73
  74 Specifies a keyserver to provide the GPG key. Valid options: a string containing a domain name or a full URL (http://, https://, or
  75 hkp://).
  76
  77 Default value: $apt::params::keyserver
  78
  79 ##### `key_options`
  80
  81 Data type: `Optional[String]`
  82
  83 Specifies the default options for apt::key resources.
  84
  85 Default value: $apt::params::key_options
  86
  87 ##### `ppa_options`
  88
  89 Data type: `Optional[String]`
  90
  91 Supplies options to be passed to the `add-apt-repository` command.
  92
  93 Default value: $apt::params::ppa_options
  94
  95 ##### `ppa_package`
  96
  97 Data type: `Optional[String]`
  98
  99 Names the package that provides the `apt-add-repository` command.
 100
 101 Default value: $apt::params::ppa_package
 102
 103 ##### `backports`
 104
 105 Data type: `Optional[Hash]`
 106
 107 Specifies some of the default parameters used by apt::backports. Valid options: a hash made up from the following keys:
 108
 109 Options:
 110
 111 * **:location** `String`: See apt::backports for documentation.
 112 * **:repos** `String`: See apt::backports for documentation.
 113 * **:key** `String`: See apt::backports for documentation.
 114
 115 Default value: $apt::params::backports
 116
 117 ##### `confs`
 118
 119 Data type: `Hash`
 120
 121 Creates new `apt::conf` resources. Valid options: a hash to be passed to the create_resources function linked above.
 122
 123 Default value: $apt::params::confs
 124
 125 ##### `update`
 126
 127 Data type: `Hash`
 128
 129 Configures various update settings. Valid options: a hash made up from the following keys:
 130
 131 Options:
 132
 133 * **:frequency** `String`: Specifies how often to run `apt-get update`. If the exec resource `apt_update` is notified, `apt-get update` runs regardless of this value.
 134 Valid options: 'always' (at every Puppet run); 'daily' (if the value of `apt_update_last_success` is less than current epoch time minus 86400);
 135 'weekly' (if the value of `apt_update_last_success` is less than current epoch time minus 604800); and 'reluctantly' (only if the exec resource
 136 `apt_update` is notified). Default: 'reluctantly'.
 137 * **:loglevel** `Integer`: Specifies the log level of logs outputted to the console. Default: undef.
 138 * **:timeout** `Integer`: Specifies how long to wait for the update to complete before canceling it. Valid options: an integer, in seconds. Default: undef.
 139 * **:tries** `Integer`: Specifies how many times to retry the update after receiving a DNS or HTTP error. Default: undef.
 140
 141 Default value: $apt::params::update
 142
 143 ##### `purge`
 144
 145 Data type: `Hash`
 146
 147 Specifies whether to purge any existing settings that aren't managed by Puppet. Valid options: a hash made up from the following keys:
 148
 149 Options:
 150
 151 * **:sources.list** `Boolean`: Specifies whether to purge any unmanaged entries from sources.list. Default false.
 152 * **:sources.list.d** `Boolean`: Specifies whether to purge any unmanaged entries from sources.list.d. Default false.
 153 * **:preferences** `Boolean`: Specifies whether to purge any unmanaged entries from preferences. Default false.
 154 * **:preferences.d.** `Boolean`: Specifies whether to purge any unmanaged entries from preferences.d. Default false.
 155
 156 Default value: $apt::params::purge
 157
 158 ##### `proxy`
 159
 160 Data type: `Apt::Proxy`
 161
 162 Configures Apt to connect to a proxy server. Valid options: a hash matching the locally defined type apt::proxy.
 163
 164 Default value: $apt::params::proxy
 165
 166 ##### `sources`
 167
 168 Data type: `Hash`
 169
 170 Creates new `apt::source` resources. Valid options: a hash to be passed to the create_resources function linked above.
 171
 172 Default value: $apt::params::sources
 173
 174 ##### `keys`
 175
 176 Data type: `Hash`
 177
 178 Creates new `apt::key` resources. Valid options: a hash to be passed to the create_resources function linked above.
 179
 180 Default value: $apt::params::keys
 181
 182 ##### `ppas`
 183
 184 Data type: `Hash`
 185
 186 Creates new `apt::ppa` resources. Valid options: a hash to be passed to the create_resources function linked above.
 187
 188 Default value: $apt::params::ppas
 189
 190 ##### `pins`
 191
 192 Data type: `Hash`
 193
 194 Creates new `apt::pin` resources. Valid options: a hash to be passed to the create_resources function linked above.
 195
 196 Default value: $apt::params::pins
 197
 198 ##### `settings`
 199
 200 Data type: `Hash`
 201
 202 Creates new `apt::setting` resources. Valid options: a hash to be passed to the create_resources function linked above.
 203
 204 Default value: $apt::params::settings
 205
 206 ##### `manage_auth_conf`
 207
 208 Data type: `Boolean`
 209
 210 Specifies whether to manage the /etc/apt/auth.conf file. When true, the file will be overwritten with the entries specified in
 211 the auth_conf_entries parameter. When false, the file will be ignored (note that this does not set the file to absent.
 212
 213 Default value: $apt::params::manage_auth_conf
 214
 215 ##### `auth_conf_entries`
 216
 217 Data type: `Array[Apt::Auth_conf_entry]`
 218
 219 An optional array of login configuration settings (hashes) that are recorded in the file /etc/apt/auth.conf. This file has a netrc-like
 220 format (similar to what curl uses) and contains the login configuration for APT sources and proxies that require authentication. See
 221 https://manpages.debian.org/testing/apt/apt_auth.conf.5.en.html for details. If specified each hash must contain the keys machine, login and
 222 password and no others. Specifying manage_auth_conf and not specifying this parameter will set /etc/apt/auth.conf to absent.
 223
 224 Default value: $apt::params::auth_conf_entries
 225
 226 ##### `auth_conf_owner`
 227
 228 Data type: `String`
 229
 230 The owner of the file /etc/apt/auth.conf. Default: '_apt' or 'root' on old releases.
 231
 232 Default value: $apt::params::auth_conf_owner
 233
 234 ##### `root`
 235
 236 Data type: `String`
 237
 238 Specifies root directory of Apt executable.
 239
 240 Default value: $apt::params::root
 241
 242 ##### `sources_list`
 243
 244 Data type: `String`
 245
 246 Specifies the path of the sources_list file to use.
 247
 248 Default value: $apt::params::sources_list
 249
 250 ##### `sources_list_d`
 251
 252 Data type: `String`
 253
 254 Specifies the path of the sources_list.d file to use.
 255
 256 Default value: $apt::params::sources_list_d
 257
 258 ##### `conf_d`
 259
 260 Data type: `String`
 261
 262 Specifies the path of the conf.d file to use.
 263
 264 Default value: $apt::params::conf_d
 265
 266 ##### `preferences`
 267
 268 Data type: `String`
 269
 270 Specifies the path of the preferences file to use.
 271
 272 Default value: $apt::params::preferences
 273
 274 ##### `preferences_d`
 275
 276 Data type: `String`
 277
 278 Specifies the path of the preferences.d file to use.
 279
 280 Default value: $apt::params::preferences_d
 281
 282 ##### `config_files`
 283
 284 Data type: `Hash`
 285
 286 A hash made up of the various configuration files used by Apt.
 287
 288 Default value: $apt::params::config_files
 289
 290 ##### `update_defaults`
 291
 292 Data type: `Hash`
 293
 294
 295
 296 Default value: $apt::params::update_defaults
 297
 298 ##### `purge_defaults`
 299
 300 Data type: `Hash`
 301
 302
 303
 304 Default value: $apt::params::purge_defaults
 305
 306 ##### `proxy_defaults`
 307
 308 Data type: `Hash`
 309
 310
 311
 312 Default value: $apt::params::proxy_defaults
 313
 314 ##### `include_defaults`
 315
 316 Data type: `Hash`
 317
 318
 319
 320 Default value: $apt::params::include_defaults
 321
 322 ##### `apt_conf_d`
 323
 324 Data type: `String`
 325
 326
 327
 328 Default value: $apt::params::apt_conf_d
 329
 330 ##### `source_key_defaults`
 331
 332 Data type: `Hash`
 333
 334
 335
 336 Default value: $apt::params::source_key_defaults
 337
 338 ### apt::backports
 339
 340 Manages backports.
 341
 342 #### Examples
 343
 344 ##### Set up a backport for linuxmint qiana
 345
 346 ```puppet
 347 apt::backports { 'qiana':
 348   location => 'http://us.archive.ubuntu.com/ubuntu',
 349   release  => 'trusty-backports',
 350   repos    => 'main universe multiverse restricted',
 351   key      => {
 352     id     => '630239CC130E1A7FD81A27B140976EAF437D05B5',
 353     server => 'hkps.pool.sks-keyservers.net',
 354   },
 355 }
 356 ```
 357
 358 #### Parameters
 359
 360 The following parameters are available in the `apt::backports` class.
 361
 362 ##### `location`
 363
 364 Data type: `Optional[String]`
 365
 366 Specifies an Apt repository containing the backports to manage. Valid options: a string containing a URL. Default value for Debian and
 367 Ubuntu varies:
 368
 369 - Debian: 'http://deb.debian.org/debian'
 370
 371 - Ubuntu: 'http://archive.ubuntu.com/ubuntu'
 372
 373 Default value: `undef`
 374
 375 ##### `release`
 376
 377 Data type: `Optional[String]`
 378
 379 Specifies a distribution of the Apt repository containing the backports to manage. Used in populating the `source.list` configuration file.
 380 Default: on Debian and Ubuntu, '${lsbdistcodename}-backports'. We recommend keeping this default, except on other operating
 381 systems.
 382
 383 Default value: `undef`
 384
 385 ##### `repos`
 386
 387 Data type: `Optional[String]`
 388
 389 Specifies a component of the Apt repository containing the backports to manage. Used in populating the `source.list` configuration file.
 390 Default value for Debian and Ubuntu varies:
 391
 392 - Debian: 'main contrib non-free'
 393
 394 - Ubuntu: 'main universe multiverse restricted'
 395
 396 Default value: `undef`
 397
 398 ##### `key`
 399
 400 Data type: `Optional[Variant[String, Hash]]`
 401
 402 Specifies a key to authenticate the backports. Valid options: a string to be passed to the id parameter of the apt::key defined type, or a
 403 hash of parameter => value pairs to be passed to apt::key's id, server, content, source, and/or options parameters. Default value
 404 for Debian and Ubuntu varies:
 405
 406 - Debian: 'A1BD8E9D78F7FE5C3E65D8AF8B48AD6246925553'
 407
 408 - Ubuntu: '630239CC130E1A7FD81A27B140976EAF437D05B5'
 409
 410 Default value: `undef`
 411
 412 ##### `pin`
 413
 414 Data type: `Optional[Variant[Integer, String, Hash]]`
 415
 416 Specifies a pin priority for the backports. Valid options: a number or string to be passed to the `id` parameter of the `apt::pin` defined
 417 type, or a hash of `parameter => value` pairs to be passed to `apt::pin`'s corresponding parameters.
 418
 419 Default value: 200
 420
 421 ## Defined types
 422
 423 ### apt::conf
 424
 425 Specifies a custom Apt configuration file.
 426
 427 #### Parameters
 428
 429 The following parameters are available in the `apt::conf` defined type.
 430
 431 ##### `content`
 432
 433 Data type: `Optional[String]`
 434
 435 Required unless `ensure` is set to 'absent'. Directly supplies content for the configuration file.
 436
 437 Default value: `undef`
 438
 439 ##### `ensure`
 440
 441 Data type: `Enum['present', 'absent']`
 442
 443 Specifies whether the configuration file should exist. Valid options: 'present' and 'absent'.
 444
 445 Default value: present
 446
 447 ##### `priority`
 448
 449 Data type: `Variant[String, Integer]`
 450
 451 Determines the order in which Apt processes the configuration file. Files with lower priority numbers are loaded first.
 452 Valid options: a string containing an integer or an integer.
 453
 454 Default value: 50
 455
 456 ##### `notify_update`
 457
 458 Data type: `Optional[Boolean]`
 459
 460 Specifies whether to trigger an `apt-get update` run.
 461
 462 Default value: `undef`
 463
 464 ### apt::key
 465
 466 Manages the GPG keys that Apt uses to authenticate packages.
 467
 468 * **Note** The apt::key defined type makes use of the apt_key type, but includes extra functionality to help prevent duplicate keys.
 469
 470 #### Examples
 471
 472 ##### Declare Apt key for apt.puppetlabs.com source
 473
 474 ```puppet
 475 apt::key { 'puppetlabs':
 476   id      => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
 477   server  => 'hkps.pool.sks-keyservers.net',
 478   options => 'http-proxy="http://proxyuser:proxypass@example.org:3128"',
 479 }
 480 ```
 481
 482 #### Parameters
 483
 484 The following parameters are available in the `apt::key` defined type.
 485
 486 ##### `id`
 487
 488 Data type: `Pattern[/\A(0x)?[0-9a-fA-F]{8}\Z/, /\A(0x)?[0-9a-fA-F]{16}\Z/, /\A(0x)?[0-9a-fA-F]{40}\Z/]`
 489
 490 Specifies a GPG key to authenticate Apt package signatures. Valid options: a string containing a key ID (8 or 16 hexadecimal
 491 characters, optionally prefixed with "0x") or a full key fingerprint (40 hexadecimal characters).
 492
 493 Default value: $title
 494
 495 ##### `ensure`
 496
 497 Data type: `Enum['present', 'absent', 'refreshed']`
 498
 499 Specifies whether the key should exist. Valid options: 'present', 'absent' or 'refreshed'. Using 'refreshed' will make keys auto
 500 update when they have expired (assuming a new key exists on the key server).
 501
 502 Default value: present
 503
 504 ##### `content`
 505
 506 Data type: `Optional[String]`
 507
 508 Supplies the entire GPG key. Useful in case the key can't be fetched from a remote location and using a file resource is inconvenient.
 509
 510 Default value: `undef`
 511
 512 ##### `source`
 513
 514 Data type: `Optional[Pattern[/\Ahttps?:\/\//, /\Aftp:\/\//, /\A\/\w+/]]`
 515
 516 Specifies the location of an existing GPG key file to copy. Valid options: a string containing a URL (ftp://, http://, or https://) or
 517 an absolute path.
 518
 519 Default value: `undef`
 520
 521 ##### `server`
 522
 523 Data type: `Pattern[/\A((hkp|hkps|http|https):\/\/)?([a-z\d])([a-z\d-]{0,61}\.)+[a-z\d]+(:\d{2,5})?(\/[a-zA-Z\d\-_.]+)*\/?$/]`
 524
 525 Specifies a keyserver to provide the GPG key. Valid options: a string containing a domain name or a full URL (http://, https://,
 526 hkp:// or hkps://). The hkps:// protocol is currently only supported on Ubuntu 18.04.
 527
 528 Default value: $::apt::keyserver
 529
 530 ##### `weak_ssl`
 531
 532 Data type: `Boolean`
 533
 534 Specifies whether strict SSL verification on a https URL should be disabled. Valid options: true or false.
 535
 536 Default value: `false`
 537
 538 ##### `options`
 539
 540 Data type: `Optional[String]`
 541
 542 Passes additional options to `apt-key adv --keyserver-options`.
 543
 544 Default value: $::apt::key_options
 545
 546 ### apt::mark
 547
 548 defined typeapt::mark
 549
 550 #### Parameters
 551
 552 The following parameters are available in the `apt::mark` defined type.
 553
 554 ##### `setting`
 555
 556 Data type: `Enum['auto','manual','hold','unhold']`
 557
 558 auto, manual, hold, unhold
 559 specifies the behavior of apt in case of no more dependencies installed
 560 https://manpages.debian.org/sretch/apt/apt-mark.8.en.html
 561
 562 ### apt::pin
 563
 564 Manages Apt pins. Does not trigger an apt-get update run.
 565
 566 * **See also**
 567 http://linux.die.net/man/5/apt_preferences
 568 for context on these parameters
 569
 570 #### Parameters
 571
 572 The following parameters are available in the `apt::pin` defined type.
 573
 574 ##### `ensure`
 575
 576 Data type: `Optional[Enum['file', 'present', 'absent']]`
 577
 578 Specifies whether the pin should exist. Valid options: 'file', 'present', and 'absent'.
 579
 580 Default value: present
 581
 582 ##### `explanation`
 583
 584 Data type: `Optional[String]`
 585
 586 Supplies a comment to explain the pin. Default: "${caller_module_name}: ${name}".
 587
 588 Default value: `undef`
 589
 590 ##### `order`
 591
 592 Data type: `Variant[Integer]`
 593
 594 Determines the order in which Apt processes the pin file. Files with lower order numbers are loaded first.
 595
 596 Default value: 50
 597
 598 ##### `packages`
 599
 600 Data type: `Variant[String, Array]`
 601
 602 Specifies which package(s) to pin.
 603
 604 Default value: '*'
 605
 606 ##### `priority`
 607
 608 Data type: `Variant[Numeric, String]`
 609
 610 Sets the priority of the package. If multiple versions of a given package are available, `apt-get` installs the one with the highest
 611 priority number (subject to dependency constraints). Valid options: an integer.
 612
 613 Default value: 0
 614
 615 ##### `release`
 616
 617 Data type: `Optional[String]`
 618
 619 Tells APT to prefer packages that support the specified release. Typical values include 'stable', 'testing', and 'unstable'.
 620
 621 Default value: ''
 622
 623 ##### `release_version`
 624
 625 Data type: `Optional[String]`
 626
 627 Tells APT to prefer packages that support the specified operating system release version (such as Debian release version 7).
 628
 629 Default value: ''
 630
 631 ##### `component`
 632
 633 Data type: `Optional[String]`
 634
 635 Names the licensing component associated with the packages in the directory tree of the Release file.
 636
 637 Default value: ''
 638
 639 ##### `originator`
 640
 641 Data type: `Optional[String]`
 642
 643 Names the originator of the packages in the directory tree of the Release file.
 644
 645 Default value: ''
 646
 647 ##### `label`
 648
 649 Data type: `Optional[String]`
 650
 651 Names the label of the packages in the directory tree of the Release file.
 652
 653 Default value: ''
 654
 655 ##### `origin`
 656
 657 Data type: `Optional[String]`
 658
 659
 660
 661 Default value: ''
 662
 663 ##### `version`
 664
 665 Data type: `Optional[String]`
 666
 667
 668
 669 Default value: ''
 670
 671 ##### `codename`
 672
 673 Data type: `Optional[String]`
 674
 675
 676
 677 Default value: ''
 678
 679 ### apt::ppa
 680
 681 Manages PPA repositories using `add-apt-repository`. Not supported on Debian.
 682
 683 #### Examples
 684
 685 ##### Example declaration of an Apt PPA
 686
 687 ```puppet
 688 apt::ppa{ 'ppa:openstack-ppa/bleeding-edge': }
 689 ```
 690
 691 #### Parameters
 692
 693 The following parameters are available in the `apt::ppa` defined type.
 694
 695 ##### `ensure`
 696
 697 Data type: `String`
 698
 699 Specifies whether the PPA should exist. Valid options: 'present' and 'absent'.
 700
 701 Default value: 'present'
 702
 703 ##### `options`
 704
 705 Data type: `Optional[String]`
 706
 707 Supplies options to be passed to the `add-apt-repository` command. Default: '-y'.
 708
 709 Default value: $::apt::ppa_options
 710
 711 ##### `release`
 712
 713 Data type: `Optional[String]`
 714
 715 Optional if lsb-release is installed (unless you're using a different release than indicated by lsb-release, e.g., Linux Mint).
 716 Specifies the operating system of your node. Valid options: a string containing a valid LSB distribution codename.
 717
 718 Default value: $facts['lsbdistcodename']
 719
 720 ##### `dist`
 721
 722 Data type: `Optional[String]`
 723
 724 Optional if lsb-release is installed (unless you're using a different release than indicated by lsb-release, e.g., Linux Mint).
 725 Specifies the distribution of your node. Valid options: a string containing a valid distribution codename.
 726
 727 Default value: $facts['lsbdistid']
 728
 729 ##### `package_name`
 730
 731 Data type: `Optional[String]`
 732
 733 Names the package that provides the `apt-add-repository` command. Default: 'software-properties-common'.
 734
 735 Default value: $::apt::ppa_package
 736
 737 ##### `package_manage`
 738
 739 Data type: `Boolean`
 740
 741 Specifies whether Puppet should manage the package that provides `apt-add-repository`.
 742
 743 Default value: `false`
 744
 745 ### apt::setting
 746
 747 Manages Apt configuration files.
 748
 749 * **See also**
 750 https://docs.puppetlabs.com/references/latest/type.html#file-attributes
 751 for more information on source and content parameters
 752
 753 #### Parameters
 754
 755 The following parameters are available in the `apt::setting` defined type.
 756
 757 ##### `priority`
 758
 759 Data type: `Variant[String, Integer, Array]`
 760
 761 Determines the order in which Apt processes the configuration file. Files with higher priority numbers are loaded first.
 762
 763 Default value: 50
 764
 765 ##### `ensure`
 766
 767 Data type: `Optional[Enum['file', 'present', 'absent']]`
 768
 769 Specifies whether the file should exist. Valid options: 'present', 'absent', and 'file'.
 770
 771 Default value: file
 772
 773 ##### `source`
 774
 775 Data type: `Optional[String]`
 776
 777 Required, unless `content` is set. Specifies a source file to supply the content of the configuration file. Cannot be used in combination
 778 with `content`. Valid options: see link above for Puppet's native file type source attribute.
 779
 780 Default value: `undef`
 781
 782 ##### `content`
 783
 784 Data type: `Optional[String]`
 785
 786 Required, unless `source` is set. Directly supplies content for the configuration file. Cannot be used in combination with `source`. Valid
 787 options: see link above for Puppet's native file type content attribute.
 788
 789 Default value: `undef`
 790
 791 ##### `notify_update`
 792
 793 Data type: `Boolean`
 794
 795 Specifies whether to trigger an `apt-get update` run.
 796
 797 Default value: `true`
 798
 799 ### apt::source
 800
 801 Manages the Apt sources in /etc/apt/sources.list.d/.
 802
 803 #### Examples
 804
 805 ##### Install the puppetlabs apt source
 806
 807 ```puppet
 808 apt::source { 'puppetlabs':
 809   location => 'http://apt.puppetlabs.com',
 810   repos    => 'main',
 811   key      => {
 812     id     => '6F6B15509CF8E59E6E469F327F438280EF8D349F',
 813     server => 'hkps.pool.sks-keyservers.net',
 814   },
 815 }
 816 ```
 817
 818 #### Parameters
 819
 820 The following parameters are available in the `apt::source` defined type.
 821
 822 ##### `location`
 823
 824 Data type: `Optional[String]`
 825
 826 Required, unless ensure is set to 'absent'. Specifies an Apt repository. Valid options: a string containing a repository URL.
 827
 828 Default value: `undef`
 829
 830 ##### `comment`
 831
 832 Data type: `String`
 833
 834 Supplies a comment for adding to the Apt source file.
 835
 836 Default value: $name
 837
 838 ##### `ensure`
 839
 840 Data type: `String`
 841
 842 Specifies whether the Apt source file should exist. Valid options: 'present' and 'absent'.
 843
 844 Default value: present
 845
 846 ##### `release`
 847
 848 Data type: `Optional[String]`
 849
 850 Specifies a distribution of the Apt repository.
 851
 852 Default value: `undef`
 853
 854 ##### `repos`
 855
 856 Data type: `String`
 857
 858 Specifies a component of the Apt repository.
 859
 860 Default value: 'main'
 861
 862 ##### `include`
 863
 864 Data type: `Optional[Variant[Hash]]`
 865
 866 Configures include options. Valid options: a hash of available keys.
 867
 868 Options:
 869
 870 * **:deb** `Boolean`: Specifies whether to request the distribution's compiled binaries. Default true.
 871 * **:src** `Boolean`: Specifies whether to request the distribution's uncompiled source code. Default false.
 872
 873 Default value: {}
 874
 875 ##### `key`
 876
 877 Data type: `Optional[Variant[String, Hash]]`
 878
 879 Creates a declaration of the apt::key defined type. Valid options: a string to be passed to the `id` parameter of the `apt::key`
 880 defined type, or a hash of `parameter => value` pairs to be passed to `apt::key`'s `id`, `server`, `content`, `source`, and/or
 881 `options` parameters.
 882
 883 Default value: `undef`
 884
 885 ##### `pin`
 886
 887 Data type: `Optional[Variant[Hash, Numeric, String]]`
 888
 889 Creates a declaration of the apt::pin defined type. Valid options: a number or string to be passed to the `id` parameter of the
 890 `apt::pin` defined type, or a hash of `parameter => value` pairs to be passed to `apt::pin`'s corresponding parameters.
 891
 892 Default value: `undef`
 893
 894 ##### `architecture`
 895
 896 Data type: `Optional[String]`
 897
 898 Tells Apt to only download information for specified architectures. Valid options: a string containing one or more architecture names,
 899 separated by commas (e.g., 'i386' or 'i386,alpha,powerpc'). Default: undef (if unspecified, Apt downloads information for all architectures
 900 defined in the Apt::Architectures option).
 901
 902 Default value: `undef`
 903
 904 ##### `allow_unsigned`
 905
 906 Data type: `Boolean`
 907
 908 Specifies whether to authenticate packages from this release, even if the Release file is not signed or the signature can't be checked.
 909
 910 Default value: `false`
 911
 912 ##### `notify_update`
 913
 914 Data type: `Boolean`
 915
 916 Specifies whether to trigger an `apt-get update` run.
 917
 918 Default value: `true`
 919
 920 ## Resource types
 921
 922 ## Data types
 923
 924 ### Apt::Auth_conf_entry
 925
 926 Login configuration settings that are recorded in the file `/etc/apt/auth.conf`.
 927
 928 * **See also**
 929 https://manpages.debian.org/testing/apt/apt_auth.conf.5.en.html
 930 for more information
 931
 932 Alias of `Struct[{
 933     machine => String[1],
 934     login => String,
 935     password => String
 936   }]`
 937
 938 #### Parameters
 939
 940 The following parameters are available in the `Apt::Auth_conf_entry` data type.
 941
 942 ##### `machine`
 943
 944 Hostname of machine to connect to.
 945
 946 ##### `login`
 947
 948 Specifies the username to connect with.
 949
 950 ##### `password`
 951
 952 Specifies the password to connect with.
 953
 954 ### Apt::Proxy
 955
 956 Configures Apt to connect to a proxy server.
 957
 958 Alias of `Struct[{
 959     ensure => Optional[Enum['file', 'present', 'absent']],
 960     host   => Optional[String],
 961     port   => Optional[Integer[0, 65535]],
 962     https  => Optional[Boolean],
 963     direct => Optional[Boolean],
 964   }]`
 965
 966 #### Parameters
 967
 968 The following parameters are available in the `Apt::Proxy` data type.
 969
 970 ##### `ensure`
 971
 972 Specifies whether the proxy should exist. Valid options: 'file', 'present', and 'absent'. Prefer 'file' over 'present'.
 973
 974 ##### `host`
 975
 976 Specifies a proxy host to be stored in `/etc/apt/apt.conf.d/01proxy`. Valid options: a string containing a hostname.
 977
 978 ##### `port`
 979
 980 Specifies a proxy port to be stored in `/etc/apt/apt.conf.d/01proxy`. Valid options: an integer containing a port number.
 981
 982 ##### `https`
 983
 984 Specifies whether to enable https proxies.
 985
 986 ##### `direct`
 987
 988 Specifies whether or not to use a `DIRECT` https proxy if http proxy is used but https is not.
 989
 990 ## Tasks
 991
 992 ### init
 993
 994 Allows you to perform apt functions
 995
 996 **Supports noop?** false
 997
 998 #### Parameters
 999
1000 ##### `action`
1001
1002 Data type: `Enum[update, upgrade, dist-upgrade, autoremove]`
1003
1004 Action to perform
1005