deploy: 3a29643

concepts-advanced/service-types/index.html

@@ -752,6 +752,20 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
 
+        <li class="md-nav__item">
+  <a href="#additional-volumes" class="md-nav__link">
+    Additional Volumes
+  </a>
+
+</li>
+
+        <li class="md-nav__item">
+  <a href="#additional-service-ports" class="md-nav__link">
+    Additional Service Ports
+  </a>
+
+</li>
+
         <li class="md-nav__item">
   <a href="#basic" class="md-nav__link">
     basic
@@ -4847,6 +4861,20 @@
     </label>
     <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
 
+        <li class="md-nav__item">
+  <a href="#additional-volumes" class="md-nav__link">
+    Additional Volumes
+  </a>
+
+</li>
+
+        <li class="md-nav__item">
+  <a href="#additional-service-ports" class="md-nav__link">
+    Additional Service Ports
+  </a>
+
+</li>
+
         <li class="md-nav__item">
   <a href="#basic" class="md-nav__link">
     basic
@@ -5089,11 +5117,16 @@
 
 <h1 id="service-types">Service Types<a class="headerlink" href="#service-types" title="Permanent link">#</a></h1>
 <p>The below lists all service types that can be defined via <code>lagoon.type</code> within a <a href="../../concepts-basics/docker-compose-yml/"><code>docker-compose.yml</code> file</a>.</p>
-<p>For more information on the <code>lagoon.volumes.X.path</code> label, please see <a href="../../concepts-basics/docker-compose-yml/#additional-volumes">Additional Volumes</a></p>
 <div class="admonition warning">
 <p class="admonition-title">Warning</p>
 <p>Once a <code>lagoon.type</code> is defined and the environment is deployed, changing it to a different type is not supported and could result in a broken environment.</p>
 </div>
+<h2 id="additional-volumes">Additional Volumes<a class="headerlink" href="#additional-volumes" title="Permanent link">#</a></h2>
+<p>Some service types allow for additional volumes to be added, for more information on the <code>lagoon.volumes.X.path</code> label, please see <a href="../../concepts-basics/docker-compose-yml/#additional-volumes">Additional Volumes</a></p>
+<p>If you're provisioning a new project, we recommend avoiding the usage of <code>-persistent</code> service types, and use additional volumes as required for any persistent data.</p>
+<h2 id="additional-service-ports">Additional Service Ports<a class="headerlink" href="#additional-service-ports" title="Permanent link">#</a></h2>
+<p>Most services provide a default port, in cases where you want to use the services already defined in your <code>docker-compose.yml</code> file, you can configure a service to use those ports instead.</p>
+<p>To use this feature, you set the <code>lagoon.service.usecomposeports: true</code> label on the service in your <code>docker-compose.yml</code> file. For more information on how to use this feature, see <a href="../../concepts-basics/docker-compose-yml/#additional-service-ports">Additional Service Ports</a></p>
 <h2 id="basic"><code>basic</code><a class="headerlink" href="#basic" title="Permanent link">#</a></h2>
 <p>Basic container, good to use for most applications that don't have an existing template. No persistent storage. The port can be changed using a label. If an <a href="../../concepts-basics/docker-compose-yml/#auto-generated-routes">autogenerated route</a> is not required (e.g. for an internal-facing service, set <code>lagoon.autogeneratedroute: false</code> in the docker-compose.yml)</p>
 <table>