Files
help365/platform/kubernetes-air-gap.html
koziavin 00717a92fb
All checks were successful
Deploy Static Site / deploy (push) Successful in 6m6s
update
2025-05-29 16:42:45 +04:00

235 lines
24 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="en">
<head>
<title>Install BRIX to an air-gapped Kubernetes cluster</title>
<meta name="generator" content="Help+Manual" />
<meta name="keywords" content="" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="BRIX Helm can be installed in a private environment that has no access to the public container image registry. To do that, you first need to install a private registry, for..." />
<meta name="picture" content="" />
<meta property="og:type" content="website" />
<meta property="og:title" content="Full documentation for BRIX365 platform. Low-code developer guide. User guide. Admin guide. Developer guide." />
<meta property="og:url" content="https://brix365.com/en/help" />
<meta property="og:image" content="" />
<link rel="icon" href="favicon.png" type="image/png" />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
<link rel="stylesheet" href="./jquery-ui.min.css" />
<link rel="stylesheet" href="default.css" />
<link rel="stylesheet" href="./search-yandex.css" />
<link rel="stylesheet" href="./article.css" />
<link rel="stylesheet" href="./glossary.css" />
<link rel="stylesheet" href="./theme.css" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="helpman_settings.js"></script>
<script type="text/javascript" src="helpman_topicinit.js"></script>
<script type="text/javascript" src="highlight.js"></script>
<script type="text/javascript">
$(document).ready(function(){highlight();});
</script>
</head>
<body>
<script>!function(e,t,c,n,r,a,m){e.ym=e.ym||function(){(e.ym.a=e.ym.a||[]).push(arguments)},e.ym.l=1*new Date;for(var s=0;s<document.scripts.length;s++)if(document.scripts[s].src===n)return;a=t.createElement(c),m=t.getElementsByTagName(c)[0],a.async=1,a.src=n,m.parentNode.insertBefore(a,m)}(window,document,"script","https://mc.yandex.ru/metrika/tag.js"),ym(83179930,"init",{clickmap:!0,trackLinks:!0,accurateTrackBounce:!0,webvisor:!0})</script><noscript><div><img alt=""src=https://mc.yandex.ru/watch/83179930 style=position:absolute;left:-9999px></div></noscript>
<header class="header elma-365">
<div class="container">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-en.svg" alt="header logo">
</a>
<!-- <div class="hero__search-form" id="search-panel">
<form class="search-form" onsubmit="ym(83180416,'reachGoal','poisk')">
<label class="search-form__label">
<span id="reset-search" class="search__icon"></span>
<input class="search-form__input" type="text">
</label>
<input class="search-form__submit" type="submit" value="Submit">
</form>
</div> -->
<div class="hero__search-form" id="search-panel"> <form class="search-form"> <label class="search-form__label"> <span id="reset-search" class="search__icon"></span> <input class="search-form__input" type="text"> </label> <input class="search-form__submit" type="submit" value="Submit"> </form> </div>
<div class="hero__search">
<a href="#" id="search-icon" class="hero__search-icon">
<img src="search-icon-white.svg" alt="search string">
</a>
<a href="#" id="side-menu-icon" class="hero__side-icon">
<img src="side_menu.svg" alt="side menu">
</a>
</div>
<div class="header__navi">
<ul class="header__list"><li><span class="solution-select"><span class="solution-select__selected"></span><svg width="7" height="4" viewBox="0 0 7 4" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L3.5 3.5L6 1" stroke="white" stroke-linecap="round" stroke-linejoin="round"/></svg><ul class="solution-select__list"><li><a class="project-link" href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a class="project-link" href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a class="project-link" href="https://brix365.com/en/help/crm/crm_overview.html">CRM</a></li><li><a class="project-link" href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a class="project-link" href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li><li><a class="project-link" href="https://brix365.com/en/help/business_solutions/-elma365-store.html">Business Solutions</a></li></ul></span></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li><li><a href="https://tssdk.brix365.com/" target="_blank">SDK</a></li></ul>
</div>
</div>
</header>
<main class="main container">
<aside class="sidebar" id="sidebar">
<div class="sidebar__header">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-light-en.svg">
</a>
<span class="sidebar__close elma-365-close" id="close"></span>
</div>
<div class="sidebar__wrapper" id="side-menu">
</div>
</aside>
<article class="article" id="article">
<div class="article-inner">
<div class="content">
<header class="article__header">
<div class="article__bread" style="display:flex; gap:10px;">
<span id="subcategory" class="search-res__item-category search-res__item-category_subcategory subcategory article__badge"></span>
<div class="topic__breadcrumbs">
<p><a href="elma365-on-premises.html">BRIX On-Premises</a> &gt; Other / Install BRIX to an air-gapped Kubernetes cluster</p>
</div>
</div>
<div class="topic__title"><h1 class="p_Heading1"><span class="f_Heading1">Install BRIX to an air-gapped Kubernetes cluster</span></h1>
</div>
</header>
<section class="article__content">
<div class="scroll-top-inner">
<a href="#h1-article" class="scroll-top"></a>
</div>
<!-- Placeholder for topic body. -->
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">BRIX Helm can be installed in a private environment that has no access to the public container image registry. To do that, you first need to install a private registry, for example, <a href="https://github.com/goharbor/harbor" target="_blank" class="weblink">Harbor</a>.</span></p>
<h2 class="p_Heading2"><span class="f_Heading2">Install the Harbor private registry</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">On a computer with internet access, go to the <a href="https://github.com/goharbor/harbor/releases" target="_blank" class="weblink">Harbor</a> releases page and download the </span><span style="font-family: Inter; font-weight: bold;">harbor-offline-installer-vX.Y.Z.tgz </span><span style="font-family: Inter;">archive:</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">wget https://github.com/goharbor/harbor/releases/download/vX.Y.Z/harbor-offline-installer-vX.Y.Z.tgz</span></p>
<ol style="list-style-type:upper-roman" start="2">
<li value="2" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">You need to copy the archive to the server that will be used to run the installation. Unpack the archive and open the catalog:</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">tar xzvf harbor-offline-installer-vX.Y.Z.tgz &amp;&amp; cd harbor</span></p>
<ol style="list-style-type:upper-roman" start="3">
<li value="3" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Copy the configuration example to the </span><span style="font-family: Inter; font-weight: bold;">harbor.yml </span><span style="font-family: Inter;">file:</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">cp harbor.yml.sample harbor.yml</span></p>
<ol style="list-style-type:upper-roman" start="4">
<li value="4" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Open the </span><span style="font-family: Inter; font-weight: bold;">harbor.yml </span><span style="font-family: Inter;">configuration file for editing and make the necessary changes: edit the </span><span style="font-family: Inter; font-weight: bold;">hostname</span><span style="font-family: Inter;">, the </span><span style="font-family: Inter; font-weight: bold;">HTTP</span><span style="font-family: Inter;"> and </span><span style="font-family: Inter; font-weight: bold;">HTTPS</span><span style="font-family: Inter;"> ports, the admin password, the </span><span style="font-family: Inter; font-weight: bold;">data_volume</span><span style="font-family: Inter;"> (location where images will be stored), the DB, etc. If you have a certificate, make sure the keys are at the specified locations.</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">vim harbor.yml </span></p>
<ol style="list-style-type:upper-roman" start="5">
<li value="5" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Install docker and docker-compose if these packages are missing.</span></li><li value="6" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Install Harbor using the following command:</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo ./install.sh </span></p>
<ol style="list-style-type:upper-roman" start="7">
<li value="7" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">To get access to Harbor, enter the domain specified in the configuration file in a web browser (</span><span style="font-family: Inter; font-weight: bold;">https://registry.example.com:443</span><span style="font-family: Inter;">). Sign in using the username </span><span style="font-family: Inter; font-weight: bold;">admin</span><span style="font-family: Inter;"> and the password set in </span><span style="font-family: Inter; font-weight: bold;">harbor.yml</span><span style="font-family: Inter;">.</span></li><li value="8" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Create a new project in Harbor. To do that, go to </span><span style="font-family: Inter; font-weight: bold;">Projects</span><span style="font-family: Inter;"> and click </span><span style="font-family: Inter; font-weight: bold;">+New project</span><span style="font-family: Inter;">.</span></li></ol>
<p style="line-height: 1.28; margin: 0 0 11px 0;"><img alt="kubernetes-air-gap-1" width="1033" height="477" style="margin:0;width:1033px;height:477px;border:none" src="kubernetes-air-gap-1.png"/></p>
<ol style="list-style-type:upper-roman" start="9">
<li value="9" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Enter the projects name in lowercase letters (for example, </span><span style="font-family: Inter; font-weight: bold;">images</span><span style="font-family: Inter;">) and specify whether the project needs to be public. Click </span><span style="font-family: Inter; font-weight: bold;">OK</span><span style="font-family: Inter;">.</span></li></ol>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><img alt="kubernetes-air-gap-2" width="846" height="489" style="margin:0;width:846px;height:489px;border:none" src="kubernetes-air-gap-2.png"/></p>
<h2 class="p_Heading2"><span class="f_Heading2">Upload BRIX images to the private registry</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">On a computer with internet access, download and run the script that downloads the images (the total size of the files is ~5 GB).</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">curl&nbsp;-fsSL&nbsp;-o&nbsp;elma365-charts-offline.sh&nbsp;https://dl.elma365.com/onPremise/latest/elma365-charts-offline-latest&nbsp;&amp;&amp;&nbsp;\</span><br />
<span class="f_CodeExample">chmod&nbsp;+x&nbsp;elma365-charts-offline.sh&nbsp;&amp;&amp;&nbsp;\</span><br />
<span class="f_CodeExample">./elma365-charts-offline.sh&nbsp;--pull</span></p>
<p class="p_Normal">Download links for other BRIX versions are provided in <a href="links-for-install-elma365.html" class="topiclink">Links for downloading BRIX distribution packages</a>.</p>
<ol style="list-style-type:upper-roman" start="2">
<li value="2" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">After downloading all the files, you need to copy the </span><span style="font-family: Inter; font-weight: bold;">BRIX-X.Y.Z</span><span style="font-family: Inter;"> catalog to the server that will be used for installation.</span></li><li value="3" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Open the </span><span style="font-family: Inter; font-weight: bold;">BRIX-X.Y.Z </span><span style="font-family: Inter;">catalog and upload the BRIX images to the private registry using the following command:</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">./charts-offline.sh --push --uri registry.example.com:443/images/BRIX --creds admin:Harbor12345</span></p>
<h2 class="p_Heading2"><span class="f_Heading2">Install the BRIX-dbs package</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Open the </span><span style="font-family: Inter; font-weight: bold;">BRIX-X.Y.Z/elma-dbs</span><span style="font-family: Inter;"> catalog. In the </span><span style="font-family: Inter; font-weight: bold;">values-dbs.yaml</span><span style="font-family: Inter;"> file, in the </span><span style="font-family: Inter; font-weight: bold;">image</span><span style="font-family: Inter;"> section, specify the parameters of the private registry for each DB:</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample"># Address&nbsp;and&nbsp;secret&nbsp;for&nbsp;the&nbsp;private registry.</span><br />
<span class="f_CodeExample">image:</span><br />
<span class="f_CodeExample"> &nbsp;registry: registry.example.com:443/images/BRIX</span><br />
<span class="f_CodeExample"># Secret&nbsp;with&nbsp;access&nbsp;to&nbsp;the&nbsp;private&nbsp;registry&nbsp;needs&nbsp;to&nbsp;be&nbsp;created&nbsp;manually&nbsp;and&nbsp;encrypted&nbsp;in&nbsp;Base64.</span><br />
<span class="f_CodeExample"> &nbsp;pullSecrets:</span><br />
<span class="f_CodeExample"> &nbsp;&nbsp;&nbsp;- myRegistryKeySecretName</span></p>
<ol style="list-style-type:upper-roman" start="2">
<li value="2" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Install the </span><span style="font-family: Inter; font-weight: bold;">BRIX-dbs </span><span style="font-family: Inter;">package. Read more about this in the <a href="install-kubernetes.html" class="topiclink">Install BRIX to Kubernetes</a> article.</span></li></ol>
<h2 class="p_Heading2"><span class="f_Heading2">Install the BRIX package</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Go to the </span><span style="font-family: Inter; font-weight: bold;">BRIX-X.Y.Z/BRIX</span><span style="font-family: Inter;"> catalog. In the </span><span style="font-family: Inter; font-weight: bold;">values-dbs.yaml</span><span style="font-family: Inter;"> file, in the </span><span style="font-family: Inter; font-weight: bold;">image</span><span style="font-family: Inter;"> section, specify the parameters of the private registry:</span></li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample"># Address&nbsp;and&nbsp;secret&nbsp;for&nbsp;the&nbsp;private registry.</span><br />
<span class="f_CodeExample">image:</span><br />
<span class="f_CodeExample"> &nbsp;registry: registry.example.com:443/images/BRIX</span><br />
<span class="f_CodeExample"> &nbsp;dockerRegistry: registry.example.com</span><br />
<span class="f_CodeExample"># Secret&nbsp;with&nbsp;access&nbsp;to&nbsp;the&nbsp;private&nbsp;registry&nbsp;needs&nbsp;to&nbsp;be&nbsp;created&nbsp;manually&nbsp;and&nbsp;encrypted&nbsp;in&nbsp;Base64.&nbsp;</span><br />
<span class="f_CodeExample"> &nbsp;pullSecret:</span><br />
<span class="f_CodeExample"> &nbsp;&nbsp;&nbsp;- myRegistryKeySecretName</span></p>
<ol style="list-style-type:upper-roman" start="2">
<li value="2" style="line-height: 1.20; margin-top: 7px; margin-right: 0; margin-bottom: 16px;"><span style="font-family: Inter;">Install the </span><span style="font-family: Inter; font-weight: bold;">BRIX </span><span style="font-family: Inter;">package. Read more about this in the <a href="install-kubernetes.html" class="topiclink">Install BRIX to Kubernetes</a> article.</span></li></ol>
<div class="bottom-nav">
<a id="prev-link" class="topic__navi_prev" href="install-kubernetes.html">
<span class="bottom-nav__arrow bottom-nav__arrow--prev"></span> <span
class="bottom-nav__link">install-kubernetes.html</span>
</a>
<a id="next-link" class="topic__navi_next" href="postgresql-performance-diagnostics.html">
<span class="bottom-nav__link">postgresql-performance-diagnostics.html</span> <span
class="bottom-nav__arrow bottom-nav__arrow--next"></span>
</a>
</div>
<!-- добавляет на страницу строку блок Была ли статья полезной? -->
<div class="feedback" id="feedback"><div class="feedback-help"><span><b>Was this helpful?</b></span><form action="" method="POST" class="feedback-form" id="feedback-form"><div class="feedback__popup feedback__popup-response" id="feedback__popup_thx" style="display: none;">Thanks for your feedback!</div><div class="feedback__popup" id="feedback__popup_why" style="display: none;"><div class="feedback__popup-header">Please specify why:</div><input type="radio" name="category" id="bad_recommendation" value="bad_recommendation"><label for="bad_recommendation">Recommendations did not help me</label><input type="radio" name="category" id="difficult_text" value="difficult_text"><label for="difficult_text">Article is hard to understand</label><input type="radio" name="category" id="no_answer" value="no_answer"><label for="no_answer">Didn`t answer my question</label><input type="radio" name="category" id="bad_header" value="bad_header"><label for="bad_header">Content does not match the topic</label><input type="radio" name="category" id="other_reason" value="other_reason"><label for="other_reason">Other</label></div><div class="feedback__popup" id="feedback__popup-other" style="display: none;"><div class="feedback__popup-header">How we can improve it?</div><textarea class="feedback__textarea" name="other" id=""></textarea><input type="submit" class="feedback__other-btn" value="Submit"></div><div class="feedback-form__btn-group"><input type="radio" name="useful" id="feedback__useful_yes" value="true"><label for="feedback__useful_yes"><img src="like.svg" class="small-img" alt="like"><spanclass="feedback-form__btn-group_yes-btn">Yes</spanclass="feedback-form__btn-group_yes-btn"></label><input type="radio" name="useful" id="feedback__useful_no" value="false"><label for="feedback__useful_no"><img src="dislike.svg" class="small-img" alt="dislike"><spanclass="feedback-form__btn-group_no-btn">No</spanclass="feedback-form__btn-group_no-btn"></label></div><select name="category"><option disabled="">Please specify why</option><option value="bad_recommendation" selected="">Recommendations did not help me</option><option value="difficult_text">Article is hard to understand</option><option value="no_answer">Didn`t answer my question</option><option value="bad_header">Content does not match the topic</option><option value="other_reason">Other</option></select><input type="submit"></form></div><div class="found_typo"><p style="margin: 0px; margin-top: 16px !important;"><span><b>Found a typo?</b></span> Select it and press <i>Ctrl+Enter</i> to send us feedback</p></div></div>
</section>
</div>
<aside class="article__sidebar" style="display:none">
<input type="checkbox" />
<div class="article__arrow"></div>
<div class="table-of-contents elma365-right" id="toc2Content">
<h3 class="h3-toc">In this topic</h3>
<nav id="toc2"></nav>
</div>
</aside>
</div>
</article>
</main>
<footer class="footer">
<div class="footer-container">
<div class="footer-mobile">
<ul class="footer-mobile__list"><li><a href="https://brix365.com/en/" target="_blank">BRIX</a></li><li><a href="https://tssdk.brix365.com/en/latest/" target="_blank">SDK</a></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li></ul><ul class="footer-mobile__list"><li><a href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li></ul>
</div>
<div class="footer-wrap">
<div><span class="mobile-question-popup">Send feedback</span><form method="POST" action class="question__popup question-xs" id="question__popup"><div class="question-wrap"><span class="close"></span><span class="title">Ask a question</span><label for="help_question" style="display: none;"></label><textarea name="help_question" id="help_question"></textarea><input type="submit" value="Send"></div></form><div class="hidden fade-in question-success-xs">Sent</div></div>
<div class="footer-flex-b">
<span class="footer-copy">&copy; 2025 BRIX</span>
<ul class="footer-list">
<li class="footer-item">
<a href="#" class="arrow-top" style="display: block;"></a>
</li>
</ul>
</div>
</div>
</div>
</footer>
<iframe name="hmnavigation" style="display:none!important"></iframe>
<script src="./jquery-ui.js"></script>
<!--script src="//cdn.jsdelivr.net/npm/featherlight@1.7.14/release/featherlight.min.js" type="text/javascript" charset="utf-8"></script-->
<script src="./jquery.tocify.min.js"></script>
<script src="./TypoReporter.min.js"></script>
<script src="./google-search.js"></script>
<script src="./main.js"></script>
</body>
</html>