Commit f3511c62 authored by Kostis Trantzas's avatar Kostis Trantzas
Browse files

Deployed 1911ad75 to develop in public with MkDocs 1.6.1 and mike 2.1.3

parent 6ff2aafa

public/develop/deploymentK8s/index.html

+278 −28
Original line number Diff line number Diff line
@@ -540,7 +540,7 @@ 
          <li class="md-nav__item">

  <a href="#hardware-requirements" class="md-nav__link">

    <span class="md-ellipsis">

      Hardware requirements:

      Hardware requirements

    </span>

  </a>
@@ -549,10 +549,43 @@ 
          <li class="md-nav__item">

  <a href="#software-requirements" class="md-nav__link">

    <span class="md-ellipsis">

      Software Requirements:

      Software Requirements

    </span>

  </a>

  

</li>

        

          <li class="md-nav__item">

  <a href="#exposure" class="md-nav__link">

    <span class="md-ellipsis">

      Exposure

    </span>

  </a>

  

    <nav class="md-nav" aria-label="Exposure">

      <ul class="md-nav__list">

        

          <li class="md-nav__item">

  <a href="#option-1-load-balancer" class="md-nav__link">

    <span class="md-ellipsis">

      Option 1 - Load balancer

    </span>

  </a>

  

</li>

        

          <li class="md-nav__item">

  <a href="#option-2-ingress" class="md-nav__link">

    <span class="md-ellipsis">

      Option 2 - Ingress

    </span>

  </a>

  

</li>

        

      </ul>

    </nav>

  

</li>

        

          <li class="md-nav__item">
@@ -645,13 +678,13 @@ 
</li>

      

        <li class="md-nav__item">

  <a href="#configure-helm-chart-services" class="md-nav__link">

  <a href="#configure-helm-chart" class="md-nav__link">

    <span class="md-ellipsis">

      Configure Helm Chart Services

      Configure Helm Chart

    </span>

  </a>

  

    <nav class="md-nav" aria-label="Configure Helm Chart Services">

    <nav class="md-nav" aria-label="Configure Helm Chart">

      <ul class="md-nav__list">

        

          <li class="md-nav__item">
@@ -689,6 +722,39 @@ 
    </span>

  </a>

  

    <nav class="md-nav" aria-label="3. CRIDGE Configuration">

      <ul class="md-nav__list">

        

          <li class="md-nav__item">

  <a href="#31-bundled-cridge-deployment-with-the-openslice-helm-chart-same-cluster-environment" class="md-nav__link">

    <span class="md-ellipsis">

      3.1 Bundled CRIDGE deployment with the OpenSlice Helm chart (same cluster environment)

    </span>

  </a>

  

</li>

        

          <li class="md-nav__item">

  <a href="#32-standalone-cridge-deployment" class="md-nav__link">

    <span class="md-ellipsis">

      3.2 Standalone CRIDGE deployment

    </span>

  </a>

  

</li>

        

          <li class="md-nav__item">

  <a href="#management-of-multiple-kubernetes-clusters" class="md-nav__link">

    <span class="md-ellipsis">

      Management of multiple Kubernetes Clusters

    </span>

  </a>

  

</li>

        

      </ul>

    </nav>

  

</li>

        

          <li class="md-nav__item">
@@ -725,6 +791,15 @@ 
    </span>

  </a>

  

</li>

        

          <li class="md-nav__item">

  <a href="#8-configuring-tcp-forwarding-for-artemis" class="md-nav__link">

    <span class="md-ellipsis">

      8. Configuring TCP Forwarding for Artemis

    </span>

  </a>

  

</li>

        

      </ul>
@@ -3081,7 +3156,7 @@ 
          <li class="md-nav__item">

  <a href="#hardware-requirements" class="md-nav__link">

    <span class="md-ellipsis">

      Hardware requirements:

      Hardware requirements

    </span>

  </a>
@@ -3090,10 +3165,43 @@ 
          <li class="md-nav__item">

  <a href="#software-requirements" class="md-nav__link">

    <span class="md-ellipsis">

      Software Requirements:

      Software Requirements

    </span>

  </a>

  

</li>

        

          <li class="md-nav__item">

  <a href="#exposure" class="md-nav__link">

    <span class="md-ellipsis">

      Exposure

    </span>

  </a>

  

    <nav class="md-nav" aria-label="Exposure">

      <ul class="md-nav__list">

        

          <li class="md-nav__item">

  <a href="#option-1-load-balancer" class="md-nav__link">

    <span class="md-ellipsis">

      Option 1 - Load balancer

    </span>

  </a>

  

</li>

        

          <li class="md-nav__item">

  <a href="#option-2-ingress" class="md-nav__link">

    <span class="md-ellipsis">

      Option 2 - Ingress

    </span>

  </a>

  

</li>

        

      </ul>

    </nav>

  

</li>

        

          <li class="md-nav__item">
@@ -3186,13 +3294,13 @@ 
</li>

      

        <li class="md-nav__item">

  <a href="#configure-helm-chart-services" class="md-nav__link">

  <a href="#configure-helm-chart" class="md-nav__link">

    <span class="md-ellipsis">

      Configure Helm Chart Services

      Configure Helm Chart

    </span>

  </a>

  

    <nav class="md-nav" aria-label="Configure Helm Chart Services">

    <nav class="md-nav" aria-label="Configure Helm Chart">

      <ul class="md-nav__list">

        

          <li class="md-nav__item">
@@ -3230,6 +3338,39 @@ 
    </span>

  </a>

  

    <nav class="md-nav" aria-label="3. CRIDGE Configuration">

      <ul class="md-nav__list">

        

          <li class="md-nav__item">

  <a href="#31-bundled-cridge-deployment-with-the-openslice-helm-chart-same-cluster-environment" class="md-nav__link">

    <span class="md-ellipsis">

      3.1 Bundled CRIDGE deployment with the OpenSlice Helm chart (same cluster environment)

    </span>

  </a>

  

</li>

        

          <li class="md-nav__item">

  <a href="#32-standalone-cridge-deployment" class="md-nav__link">

    <span class="md-ellipsis">

      3.2 Standalone CRIDGE deployment

    </span>

  </a>

  

</li>

        

          <li class="md-nav__item">

  <a href="#management-of-multiple-kubernetes-clusters" class="md-nav__link">

    <span class="md-ellipsis">

      Management of multiple Kubernetes Clusters

    </span>

  </a>

  

</li>

        

      </ul>

    </nav>

  

</li>

        

          <li class="md-nav__item">
@@ -3266,6 +3407,15 @@ 
    </span>

  </a>

  

</li>

        

          <li class="md-nav__item">

  <a href="#8-configuring-tcp-forwarding-for-artemis" class="md-nav__link">

    <span class="md-ellipsis">

      8. Configuring TCP Forwarding for Artemis

    </span>

  </a>

  

</li>

        

      </ul>
@@ -3413,7 +3563,7 @@ 
<h1 id="openslice-deployment-guide-with-kubernetes">OpenSlice Deployment Guide with Kubernetes</h1>

<h2 id="intended-audience-openslice-administrators">Intended Audience: OpenSlice administrators</h2>

<h2 id="requirements">Requirements</h2>

<h3 id="hardware-requirements">Hardware requirements:</h3>

<h3 id="hardware-requirements">Hardware requirements</h3>

<table>

<thead>

<tr>
@@ -3436,7 +3586,7 @@ 
</tr>

</tbody>

</table>

<h3 id="software-requirements">Software Requirements:</h3>

<h3 id="software-requirements">Software Requirements</h3>

<ul>

<li><strong>git:</strong> For cloning the project repository.</li>

<li><strong>Kubernetes:</strong> A running cluster where OpenSlice will be deployed. <ul>
@@ -3445,13 +3595,32 @@ 
</li>

<li><strong>Helm:</strong> For managing the deployment of OpenSlice.</li>

<li><strong>Ingress Controller:</strong> Ingress exposes HTTP and HTTPS routes from outside the cluster to services within the cluster. Traffic routing is controlled by rules defined on the Ingress resource. An Ingress may be configured to give Services externally-reachable URLs, load balance traffic, terminate SSL / TLS, and offer name-based virtual hosting. An Ingress controller is responsible for fulfilling the Ingress, usually with a load balancer, though it may also configure your edge router or additional frontends to help handle the traffic. You must have an Ingress controller to satisfy an Ingress.<ul>

<li>An Nginx ingress controller is required, which can be installed using <a href="https://kubernetes.github.io/ingress-nginx/deploy/">this guide</a>. </li>

<li>If you use another type of ingress controller, you'll need to modify <code>[repo-root]/kubernetes/helm/openslice/templates/openslice-ingress.yaml</code> to conform to your ingress controller's requirements.</li>

<li><strong>Nginx Ingress Controller (Kubernetes Community Edition):</strong>  The ingress resource is configured to use an Nginx type ingress controller. </li>

<li>If you need to expose the message bus service (Artemis), which communicates using the TCP protocol, you must use version <strong>&gt;= 1.9.13</strong> of the Nginx Ingress Controller (a prerequisite for <a href="#management-of-multiple-kubernetes-clusters">managing multiple kubernetes clusters</a>). This version or higher includes the required functionality to handle TCP services. Otherwise, earlier versions may suffice depending on your configuration.</li>

<li>To install or upgrade to the required version, run the following command:

  <code>bash

  helm upgrade nginx-ingress ingress-nginx/ingress-nginx --namespace ingress \

  --set tcp.61616="&lt;openslice-namespace&gt;/&lt;openslice-helm-release-name&gt;-artemis:61616"</code>

  Replace <code>&lt;helm-release-name&gt;</code> with the name of your OpenSlice Helm release.</li>

<li>More details regarding the Nginx Ingress Controller (Kubernetes Community Edition) can be found <a href="https://kubernetes.github.io/ingress-nginx/deploy/">here</a>.</li>

<li><strong>Other Ingress Controller:</strong>  For non-Nginx ingress controllers, modify <code>[repo-root]/kubernetes/helm/openslice/templates/openslice-ingress.yaml</code> to meet your controller’s requirements.</li>

</ul>

</li>

</ul>

<h3 id="exposure">Exposure</h3>

<h4 id="option-1-load-balancer">Option 1 - Load balancer</h4>

<ul>

<li><strong>Network Load Balancer:</strong> Required for exposing the service (e.g., GCP, AWS, Azure, MetalLB).</li>

<li><strong>Domain/IP Address:</strong> Necessary for accessing the application. This should be configured in <code>[repo-root]/kubernetes/helm/openslice/values.yaml</code> under <code>rooturl</code>.</li>

</ul>

<h4 id="option-2-ingress">Option 2 - Ingress</h4>

<ul>

<li><strong>Ingress Controller with NodePort:</strong> You can expose the application using the NodePort of the Ingress Controller's service.</li>

<li><strong>IP Address and Port:</strong> Use the IP address of the <strong>master node</strong> and the assigned NodePort to access the application. This should be configured in <code>[repo-root]/kubernetes/helm/openslice/values.yaml</code> under <code>rooturl</code>.</li>

</ul>

<p>For example:</p>

<pre><code>rooturl: http://&lt;master-node-ip&gt;:&lt;nodeport&gt;

</code></pre>

<h3 id="additional-configuration">Additional Configuration</h3>

<ul>

<li><strong>Storage Class:</strong> In a production environment, specify your <code>storageClass</code> in <code>[repo-root]/kubernetes/helm/openslice/values.yaml</code> under <code>storageClass</code>. If not defined, PVs will be created and managed manually.<ul>
@@ -3482,7 +3651,7 @@ cd org.etsi.osl.main/kubernetes/helm/openslice/ 
<li>main branch for the most stable experience and</li>

<li>develop branch for an experience with the latest features (for develop branch installation, it is strongly advisable that you may as well follow the <a href="https://osl.etsi.org/documentation/develop/deployment/">develop documentation</a>)</li>

</ul>

<h2 id="configure-helm-chart-services">Configure Helm Chart Services</h2>

<h2 id="configure-helm-chart">Configure Helm Chart</h2>

<p>When deploying OpenSlice with Helm, service configurations are handled through the <code>values.yaml</code> file. This file allows you to define all necessary configurations for your deployment, including database credentials, service URLs, and logging levels. Below are examples of how to configure your services in Helm based on your provided values.</p>

<h3 id="configuring-services">Configuring Services</h3>

<h4 id="1-database-configuration">1. Database Configuration</h4>
@@ -3513,26 +3682,103 @@ cd org.etsi.osl.main/kubernetes/helm/openslice/ 
      adminpassword: &quot;Pa55w0rd&quot;

</code></pre>

<h4 id="3-cridge-configuration">3. CRIDGE Configuration</h4>

<p>If you want to create and manage Kubernetes Custom Resources (CRs), you will have to provide:</p>

<p>To create and manage Kubernetes Custom Resources (CRs), you have to install and configure the CRIDGE component. </p>

<p>For CRIDGE to work properly, you need to provide a <strong>cluster-wide scope kubeconfig</strong> file (typically located at <code>/home/{user}/.kube</code> directory of the Kubernetes Cluster's host). This kubeconfig file allows CRIDGE to communicate with your Kubernetes cluster.</p>

<p>There are two ways to install CRIDGE:</p>

<h5 id="31-bundled-cridge-deployment-with-the-openslice-helm-chart-same-cluster-environment">3.1 <strong>Bundled CRIDGE deployment with the OpenSlice Helm chart (same cluster environment)</strong></h5>

<p>By default, the OpenSlice Helm chart also deploys CRIDGE alongside the bundle. To configure CRIDGE, there are three different ways to provide this kubeconfig file during deployment:</p>

<ol>

<li>

<p><strong>Manual Copy to Helm Files Directory</strong>:</p>

<ul>

<li>Copy the kubeconfig file to the following directory:<br />

<code>org.etsi.osl.main/kubernetes/helm/openslice/files/org.etsi.osl.cridge</code>.</li>

<li>The deployment process will automatically copy the file into the <code>/root/.kube</code> directory of the CRIDGE container.</li>

<li><strong>Note:</strong> This method expects the kubeconfig file to be named exactly <code>kubeconfig.yaml</code> in the specified directory.</li>

</ul>

</li>

<li>

<p><strong>Passing the Kubeconfig File Using Helm (<code>--set-file</code>)</strong>:</p>

<ul>

<li>If you do not wish to manually copy the file, you can pass it directly during the Helm installation using the <code>--set-file</code> option, at the final <a href="#deploy-the-helm-chart">deployment process</a>:</li>

</ul>

<p><code>bash

 --set-file cridge.kubeconfig.raw=path/to/kubeconfig.yaml</code></p>

<ul>

<li>This method reads the specified kubeconfig file and mounts it into the CRIDGE container during deployment.</li>

</ul>

</li>

<li>

<p><strong>Passing a Base64-Encoded Kubeconfig Using Helm (<code>--set</code>)</strong>:</p>

<ul>

<li>Alternatively, you can pass the kubeconfig as a base64-encoded string, during the Helm installation using the <code>--set</code> option, at the final <a href="#deploy-the-helm-chart">deployment process</a>:</li>

</ul>

<p><code>bash

 --set cridge.kubeconfig.base64="$(base64 path/to/kubeconfig.yaml)"</code></p>

<ul>

<li>a cluster-wide scope kubeconf file (typically located at <code>/home/{user}/.kube</code> directory of the Kubernetes Cluster's host)</li>

<li>This method encodes the kubeconfig content and passes it directly to the CRIDGE container.</li>

</ul>

<p>You will have to copy the kubeconf file to the <code>org.etsi.osl.main/kubernetes/helm/openslice/files/org.etsi.osl.cridge</code> directory, <em>prior to the deployment</em>.</p>

<p>By default, the deployment process copies the <code>org.etsi.osl.main/kubernetes/helm/openslice/files/org.etsi.osl.cridge/config</code> file into the <code>/root/.kube</code> directory of the CRIDGE container.</p>

</li>

</ol>

<blockquote>

<p><strong>The above configuration works for the default kubeconf file names. It explicitly expects a file named <code>config</code> within the <code>org.etsi.osl.main/kubernetes/helm/openslice/files/org.etsi.osl.cridge</code> directory. If you are working with custom kubeconf file names, you will have to rename them.</strong></p>

<p><strong>Note:</strong> Regardless of the method you choose, if you're using a non-standard kubeconfig file name, make sure to adjust the references or rename the file as needed.</p>

</blockquote>

<p>OpenSlice also offers management support of <em>multiple Kubernetes Clusters</em> simultaneously. For this, you will have to:</p>

<h5 id="32-standalone-cridge-deployment">3.2 <strong>Standalone CRIDGE deployment</strong></h5>

<p>There can be cases where a separate deployment of CRIDGE, apart from the bundled OpenSlice deployment, may be needed. These cases comprise:</p>

<ul>

<li>remote cluster management, different from the one OpenSlice is installed</li>

<li>more control over the component (e.g. multiple component instances / clusters)</li>

</ul>

<p>In this case, initially you have to disable CRIDGE from deploying with the rest of OpenSlice. To do so, in the <code>values.yaml</code> of OpenSlice Helm chart, you have to change the <code>cridge.enabled</code> flag to <code>false</code>.</p>

<pre><code class="language-yaml">cridge:

  enabled: false

</code></pre>

<p>Following, clone the CRIDGE project from the GitLab, which also includes the respective standalone Helm chart.</p>

<pre><code class="language-bash">git clone https://labs.etsi.org/rep/osl/code/org.etsi.osl.cridge.git

cd org.etsi.osl.cridge/helm/cridge/

</code></pre>

<p>Similarly, to configure CRIDGE, there are three different ways to provide this kubeconfig file during deployment:</p>

<ol>

<li>

<p><strong>Manual Copy to Helm Files Directory</strong>:</p>

<ul>

<li>Copy the kubeconfig file to the following directory:<br />

<code>org.etsi.osl.cridge/helm/cridge/files/org.etsi.osl.cridge</code>.</li>

<li>The deployment process will automatically copy the file into the <code>/root/.kube</code> directory of the CRIDGE container.</li>

<li><strong>Note:</strong> This method expects the kubeconfig file to be named exactly <code>kubeconfig.yaml</code> in the specified directory.</li>

</ul>

</li>

<li>

<p><strong>Passing the Kubeconfig File Using Helm (<code>--set-file</code>)</strong>:</p>

<ul>

<li>add all the respective kubeconf files into the <code>org.etsi.osl.main/compose/kubedir</code> directory. </li>

<li>create a copy of the <code>cridge.yaml</code> and <code>cridge-config.yaml</code> in <code>\org.etsi.osl.main\kubernetes\helm\openslice\templates</code> directory for every Cluster. <em>Mind the need for different naming</em>.</li>

<li>update every <code>cridge-config.yaml</code> file to get the appropriate kubeconf file for every Cluster.</li>

</ul>

<p>Below you may find an indicative example that only references the affected fields of each cridge-config.yaml file:</p>

<pre><code class="language-yaml">data:

  config: |-

    {{- .Files.Get &quot;files/org.etsi.osl.cridge/config-clusterX&quot; | nindent 4 }}

<li>If you do not wish to manually copy the file, you can pass it directly during the Helm installation using the <code>--set-file</code> option:

 <code>bash

 helm install cridge-release . --set-file kubeconfig.raw=path/to/kubeconfig.yaml</code></li>

<li>This method reads the specified kubeconfig file and mounts it into the CRIDGE container during deployment.</li>

</ul>

</li>

<li>

<p><strong>Passing a Base64-Encoded Kubeconfig Using Helm (<code>--set</code>)</strong>:</p>

<ul>

<li>Alternatively, you can pass the kubeconfig as a base64-encoded string:

 <code>bash

 helm install cridge-release . --set kubeconfig.base64="$(base64 path/to/kubeconfig.yaml)"</code></li>

<li>This method encodes the kubeconfig content and passes it directly to the CRIDGE container.</li>

</ul>

</li>

</ol>

<blockquote>

<p><strong>Note:</strong> Regardless of the method you choose, if you're using a non-standard kubeconfig file name, make sure to adjust the references or rename the file as needed.</p>

<p><strong>Important Note:</strong> If you are deploying CRIDGE in the same cluster and namespace as OpenSlice, no additional configuration is required for the message bus broker URL and OpenSlice communicates with CRIDGE directly. However, if CRIDGE is installed in a <strong>separate Kubernetes cluster</strong> from the one hosting OpenSlice, it is important to configure the <code>values.yaml</code> file for the CRIDGE Helm chart to point to the correct message bus broker URL. Please see <a href="#software-requirements">Nginx Ingress Controller (Kubernetes Community Edition) configuration</a> on how to properly expose the message bus in such scenario.</p>

</blockquote>

<p>In the <code>values.yaml</code> of the CRIDGE Helm chart, you must set <code>oscreds.activemq.brokerUrl</code> to point to the IP address of the ingress controller in the OpenSlice cluster, as shown below:</p>

<pre><code class="language-yaml">oscreds:

  activemq:

    brokerUrl: &quot;tcp://&lt;openslice-rootURL&gt;:61616?jms.watchTopicAdvisories=false&quot;

</code></pre>

<h5 id="management-of-multiple-kubernetes-clusters">Management of multiple Kubernetes Clusters</h5>

<p>OpenSlice also offers management support of <em>multiple Kubernetes Clusters</em> simultaneously. </p>

<p>For this, you will have to replicate the steps in <a href="#32-standalone-cridge-deployment">Standalone CRIDGE deployment</a> for every Cluster. Each CRIDGE instance will be in charged with the management of one Kubernetes Cluster.</p>

<h4 id="4-external-services-configuration">4. External Services Configuration</h4>

<p>For configuring optional external services like Bugzilla and CentralLog, specify their URLs and credentials in the <code>values.yaml</code> file:</p>

<pre><code class="language-yaml">bugzillaurl: &quot;example.com:443/bugzilla&quot;
@@ -3565,6 +3811,10 @@ rooturl: &quot;http://3.15.198.35:8080&quot; # Example IP with port 
<pre><code class="language-yaml">mysql:

  storage: &quot;10Gi&quot;

</code></pre>

<h4 id="8-configuring-tcp-forwarding-for-artemis">8. Configuring TCP Forwarding for Artemis</h4>

<p>To expose the message bus service (Artemis) via the ingress controller, it’s essential to configure TCP traffic forwarding. Artemis listens on port <code>61616</code>, and this traffic needs to be directed to the Artemis service within your Kubernetes cluster.</p>

<p>In the <a href="#software-requirements">Ingress Controller Setup</a> section, you already configured the Nginx ingress controller to handle this TCP forwarding. By setting the rule for port <code>61616</code>, traffic arriving at the ingress will be forwarded to the Artemis service defined in your Helm release.</p>

<p>This setup ensures that the message bus service is accessible externally via the ingress controller, completing the necessary configuration for Artemis.</p>

<h3 id="configure-web-ui">Configure Web UI</h3>

<p>In folder <code>kubernetes/helm/openslice/files/org.etsi.osl.portal.web/src/js</code> you must make a copy of <code>config.js.default</code> file and rename it to <code>config.js</code>. </p>

<p>This is <strong>mandatory</strong> for the configuration file to be discoverable.</p>

public/develop/search/search_index.json

+1 −1

File changed.

Preview size limit exceeded, changes collapsed.

public/develop/sitemap.xml

+59 −59

File changed.

Preview size limit exceeded, changes collapsed.

public/develop/sitemap.xml.gz

+1 B (767 B)

File changed.

No diff preview for this file type.

View original file
View changed file