Merge pull request #5553 from Marie59/tools_subdomain

Add Tools to a subdomain

topics/community/tutorials/tools_subdomains/faqs/index.md

@@ -0,0 +1,3 @@
+---
+layout: faq-page
+---

topics/community/tutorials/tools_subdomains/tutorial.md

@@ -0,0 +1,92 @@
+---
+layout: tutorial_hands_on
+
+title: Make your tools available on your subdomain
+questions:
+- How can a tool be added in a section ?
+- How can a section be added in a subdomain ?
+objectives:
+- Learn to manage the tool panel of a subdomain for both batch and interactive tools
+time_estimation: "30m"
+key_points:
+- Subdomain
+- Tool panel
+- Interactive tools
+tags:
+  - subdomain
+  - earth-system
+  - interactive-tools
+contributions:
+    authorship:
+        - Marie59
+    funding:
+        - gallantries
+        - fairease
+        - eurosciencegateway
+
+---
+This tutorial explains how to make your brand new tools, once they're published through a Pull Request ([check this tutorial]({%link topics/dev/tutorials/tool-from-scratch/tutorial.md %}) on how to build your tool from scracth), visible on your subdomain. Here we'll follow the example on how to make the tools visible on [Galaxy for earth System](https://earth-system.usegalaxy.eu/). You can also find the explanations on how to add your tools on this [Github page](https://usegalaxy-eu.github.io/operations/subdomains.html).
+
+> <agenda-title></agenda-title>
+>
+> In this tutorial, we will cover:
+>
+> 1. TOC
+> {:toc}
+>
+{: .agenda}
+
+# Add your batch tool to the right section
+
+> <hands-on-title>Tool sections (for batch tools) </hands-on-title>
+>    - Clone the Github repository of the Galaxy server (of where your subdomain to be attached)
+>    - For Galaxy Europe, fork the [usegalaxy-eu-tools repo](https://github.com/usegalaxy-eu/usegalaxy-eu-tools)
+>    - Create a branch on your fork
+>    - Browse through the different yaml files and select the one that correspond to your subdomain for earth system everything is made under the ecology owner.  The name of the files corresponds to a toolshed owner or community and a few of those communities with a review system and CI integration gets special trust and auto-updates.
+>    - Once in the yaml you can add the section for your tool (you want to know what are the existing tool sections ? Go check the [categories defined here](https://github.com/usegalaxy-eu/infrastructure-playbook/blob/master/templates/galaxy/config/tool_conf.xml.j2)) 
+> 
+> An example on how to fill in the yaml file
+> ```
+> - name: id_of_your_tool
+>   owner: choose_the_owner_relative_to_a_github_repo
+>   tool_panel_section_label: 'Choose the section where your tool belongs'
+> ```
+> 
+> ![Image of the modification to make in the ecology.yaml file](../../images/tool_subdomain/ecology_yml_tool.png)
+>
+>   - Then commit your changes and write a nice message for the admin when you open your Pull Request.
+{: .hands_on}
+
+This part is only to make batch tool visible in your subdomain.
+
+# Add a section of tools to your subdomain
+> <hands-on-title>Sections for your subdomain</hands-on-title>
+>    - If not already done clone the Galaxy Europe [Infrastructure-playbook repo](https://github.com/usegalaxy-eu/infrastructure-playbook/tree/master)
+>    - Create a branch on your fork
+>    - Go to the file **global_host_filters.py.j2** in **templates/galaxy/config/**
+>    - Open it and edit it the "DOMAIN_SECTIONS" part go to your subdomain line and in the list of section add the one you need for instance `"climate_analysis"`
+>
+> ![Image of the modification to make in the global_host_filters.py.j2 file](../../images/tool_subdomain/add_section.png)
+>
+>   - Then commit your changes and write a nice message for the admin when you open your Pull Request.
+{: .hands_on}
+
+
+# Add you interactive tool to the right section
+> <hands-on-title>Interactive tool sections</hands-on-title>
+>    - If not already done clone the Galaxy Europe [Infrastructure-playbook repo](https://github.com/usegalaxy-eu/infrastructure-playbook/tree/master)
+>    - Create a branch on your fork
+>    - Go to the file **tool_conf.xml.j2** in **templates/galaxy/config/**
+>    - Open it and edit it by adding the xml file of the interactive tool to the section interactive tool or any other interactive tool section (to know more on how to create your interactive tool section folow [this tutorial]({%link topics/admin/tutorials/subdomain/tutorial.md %}))
+>    - Below an example of how to add the interactive tool panoply to the earth system subdomain.
+>
+> ![Image of the modification to make in the tool_conf.xml.j2 file](../../images/tool_subdomain/add_interactive_tool.png)
+>
+>   - Then, commit your changes and write a nice message for the admin when you open your Pull Request.
+{: .hands_on}
+
+If you choose to create a new section for your interactive tool don't forget add this section to your subdomain ! 
+
+# Conclusion
+
+You can now start to build your workflow on your subdomain !