Incorrect installation instructions for Ansible #409

Checklist

• I confirm there are no unresolved issues reported on the Chocolatey Status page.
• I have verified this is the correct repository for opening this issue.
• I have verified no other issues exist related to my problem.
• I have verified this is not an issue for a specific package.
• I have verified this issue is not security related.
• I confirm I am using official, and not unofficial, or modified, Chocolatey products.

What You Are Seeing?

In the official installation instructions for ansible, this is the proposed ansible code:

- name: Ensure Chocolatey installed from internal repo
  win_chocolatey:
    name: chocolatey
    state: present
    source: http://internal/odata/repo/ChocolateyInstall.ps1

With this, the chocolatey package (.nupkg) is always being downloaded from community.chocolatey.org, even though I'd like to download it from an internal artifactory mirror.

What is Expected?

According to the documentation on the win_chocolatey ansible module, it shouldn't be the source field, but the bootstrap_script that specifies the powershell file:

- name: Ensure Chocolatey installed from internal repo
  win_chocolatey:
    name: chocolatey
    state: present
    bootstrap_script: http://internal/odata/repo/ChocolateyInstall.ps1

This leaves the option to also specify source, source_username and source_password. Only with these options set, the role will download chocolatey nupkg from the specified internal mirror.

How Did You Get This To Happen?

1. Follow the website instructions for ansible

User Story

No response

System Details

• Operating System: irrelevant
• Windows PowerShell version: irrelevant
• Chocolatey CLI Version: irrelevant
• Chocolatey Licensed Extension version: irrelevant
• Chocolatey License type: irrelevant
• Terminal/Emulator: irrelevant

Installed Packages

None

Output Log

None, this is a documentation problem.

Additional Context

No response

Acceptance Criteria

• Have official installation instructions for ansible match with documentation on the win_chocolatey ansible module
• Be able to install chocolatey from an internal mirror, i.e., without any external internet connections.

Related Issues

chocolatey-community/chocolatey-ansible#200