# Creation of \`microsoft.iis\` Ansible Collection

**URL:** <https://forum.ansible.com/t/creation-of-microsoft-iis-ansible-collection/10995>\
**Category:** Collection Development\
**Tags:** windows, coll-repo-request, collections\
**Created:** [November 19, 2024, 9:03am UTC](https://forum.ansible.com/t/creation-of-microsoft-iis-ansible-collection/10995 "2024-11-19T09:03:35Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![Yaish25491](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/yaish25491/32/5495_2.png) [@Yaish25491](https://forum.ansible.com/u/Yaish25491)\
**Post date:** [November 19, 2024, 9:03am UTC](https://forum.ansible.com/t/creation-of-microsoft-iis-ansible-collection/10995/1 "2024-11-19T09:03:35Z")

</div>

Hi everyone,

**TL;DR**  
As part of our ongoing work on supported Ansible Collections, we need to create a new collection named `microsoft.iis` to house Microsoft Internet Information Services (IIS) modules.

* * *

My name is Hen, and I’m part of the Red Hat team responsible for developing and maintaining supported Ansible Collections. Currently, we are migrating content from the [community.windows](https://github.com/ansible-collections/community.windows) repository into supported collections. This effort has already resulted in the creation of:

1. ansible.windows
2. microsoft.ad

The next step in the project is to create the `microsoft.iis` collection, which will focus specifically on IIS modules. Many of these modules already exist in the `community.windows` repository and will need to be reviewed, verified, and promoted to the new collection as supported content.

Could someone assist with the process of opening a new repository for this collection under the Ansible Collections organization?

Thank you,  
Hen

---

<div class="post-metadata">

**Author:** ![gundalow](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gundalow/32/99_2.png) [@gundalow](https://forum.ansible.com/u/gundalow)\
**Post date:** [November 19, 2024, 12:57pm UTC](https://forum.ansible.com/t/creation-of-microsoft-iis-ansible-collection/10995/2 "2024-11-19T12:57:26Z")

</div>

@Yaish25491 We can help with this.

What’s your GitHub id?

I’ll find the instructions to move the git files and keep history, which is important.

---

<div class="post-metadata">

**Author:** ![Yaish25491](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/yaish25491/32/5495_2.png) [@Yaish25491](https://forum.ansible.com/u/Yaish25491)\
**Post date:** [November 19, 2024, 1:50pm UTC](https://forum.ansible.com/t/creation-of-microsoft-iis-ansible-collection/10995/3 "2024-11-19T13:50:44Z")

</div>

Hi,  
Thanks for the quick response!  
Github id is the same, Yaish25491.

Just to be clear, The project should start empty with the ansible template.  
We will start promoting modules from the community once the project is up and we finish creating a working CI.

Thanks.

---

<div class="post-metadata">

**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\
**Post date:** [November 19, 2024, 2:39pm UTC](https://forum.ansible.com/t/creation-of-microsoft-iis-ansible-collection/10995/4 "2024-11-19T14:39:06Z")

</div>

You’re probably aware of this already since this is the third collection y’all are creating from `community.windows` but just in case - here are [the instructions for migrating content out of a collection.](https://docs.ansible.com/ansible/latest/dev_guide/developing_collections_migrating.html#migrate-to-collection)

---

<div class="post-metadata">

**Author:** ![gundalow](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gundalow/32/99_2.png) [@gundalow](https://forum.ansible.com/u/gundalow)\
**Post date:** [November 19, 2024, 2:56pm UTC](https://forum.ansible.com/t/creation-of-microsoft-iis-ansible-collection/10995/5 "2024-11-19T14:56:41Z")

</div>

@Yaish25491 As we want to maintain history, I’ve created an [empty repo microsoft.iis](https://github.com/ansible-collections/microsoft.iis/) and given you `write` access.

1. [Accept the invite](https://github.com/ansible-collections/microsoft.iis/invitations) to join the repo

2. Please use these instructions to copy the files from community.windows which will maintain history

> **Merging unrelated histories**
>
> # Clone the new repository and add the source as a remote.
> 
> git clone [git@github.com](mailto:git@github.com):org/new-repo.git  
> git remote add source-repo [git@github.com](mailto:git@github.com):org/source-repo.git
> 
> # Confirm that the source is a remote.
> 
> git remote -v  
> origin [git@github.com](mailto:git@github.com):org/new-repo.git (fetch)  
> origin [git@github.com](mailto:git@github.com):org/new-repo.git (push)  
> source-repo [git@github.com](mailto:git@github.com):org/source-repo.git (fetch)  
> source-repo [git@github.com](mailto:git@github.com):org/source-repo.git (push)
> 
> # View the history of the new repository.
> 
> # You should see the initial commit and any subsequent commits as you’d expect.
> 
> git log
> 
> # Fetch the content of the source repository.
> 
> git fetch source-repo
> 
> # Merge the main or devel branch of the source repository into the new repository.
> 
> git merge source-repo/main --allow-unrelated-histories
> 
> # If you encounter any conflicts you’ll need to fix them and then continue the merge.
> 
> git merge --continue
> 
> # At this point the new repository should contain the contributor history from the source repository.
> 
> # Viewing the history again should show the merge commit on top, the initial commit, and then the commit history.
> 
> git log
> 
> # You can view the history of individual files or directories.
> 
> git log --follow path/to/directory\_or\_file
> 
> # Move and delete files that were merged from the source repository as needed.
> 
> git mv path/to/directory\_or\_file  
> git rm -rf directory  
> git commit
> 
> # Push the changes to the new repository.
> 
> git push origin HEAD:main

1. Reply to this forum post and ask me to setup GitHub branch protections

2. Once you have the files copied across follow [the instructions for migrating content out of a collection](https://docs.ansible.com/ansible/latest/dev_guide/developing_collections_migrating.html#migrate-to-collection).

3. Copy/update your new repo from the [collection\_template](https://github.com/ansible-collections/collection_template)

4. Get CI green

I realize there is a lot involved in this, so please use this forum thread if you’ve got questions.

---

<div class="post-metadata">

**Author:** ![Yaish25491](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/yaish25491/32/5495_2.png) [@Yaish25491](https://forum.ansible.com/u/Yaish25491)\
**Post date:** [November 19, 2024, 3:16pm UTC](https://forum.ansible.com/t/creation-of-microsoft-iis-ansible-collection/10995/6 "2024-11-19T15:16:47Z")

</div>

@gundalow  
Thanks a lot!  
I will follow your instructions in order to maintain the history, and post question here if needed.

Thanks, Hen.
