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

259 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 Harbor</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 Enterprise can be installed in a closed environment with no direct access to an external container image repository. To achieve this, you need to pre-install a private..." />
<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; <a href="infrastructure-preparation.html">Prepare infrastructure</a> &gt; Local image registry / Install Harbor</p>
</div>
</div>
<div class="topic__title"><h1 class="p_Heading1"><span class="f_Heading1">Install Harbor</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 class="p_Normal">BRIX Enterprise can be installed in a closed environment with no direct access to an external container image repository. To achieve this, you need to pre-install a private registry, such as <a href="https://github.com/goharbor/harbor" target="_blank" class="weblink">Harbor</a>.</p>
<p class="p_Normal">The installation of the Harbor private repository involves four steps:</p>
<ol style="list-style-type:decimal">
<li value="1" class="p_Normal"><a href="installing-harbor.html#installing-docker-docker-compose" class="topiclink">Install docker and docker-compose on your OS</a>.</li><li value="2" class="p_Normal"><a href="installing-harbor.html#download-archive" class="topiclink">Download the online installer archive</a>.</li><li value="3" class="p_Normal"><a href="installing-harbor.html#complete-config-file" class="topiclink">Fill in the configuration file</a>.</li><li value="4" class="p_Normal"><a href="installing-harbor.html#installing" class="topiclink">Install Harbor</a>.</li></ol>
<h2 class="p_Heading2"><a id="installing-docker-docker-compose" class="hmanchor"></a><span class="f_Heading2">Step 1: Install docker and docker-compose</span></h2>
<p class="p_Normal">Install <a href="https://docs.docker.com/engine/install/" target="_blank" class="weblink">Docker</a> and <a href="https://docs.docker.com/compose/" target="_blank" class="weblink">Docker Compose</a> for your operating system.</p>
<h2 class="p_Heading2"><a id="download-archive" class="hmanchor"></a><span class="f_Heading2">Step 2: Download the online installer archive</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" class="p_Normal">На 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 <code><b>harbor-offline-installer-vX.Y.Z.tgz</b></code> archive by executing the following command:</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">wget&nbsp;https:</span><span class="f_CodeExample">//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" class="p_Normal">Copy the obtained archive to the server where the installation will take place.</li></ol>
<ol style="list-style-type:upper-roman" start="3">
<li value="3" class="p_Normal">Unpack the archive on the server and copy the default configuration file <code><b>harbor.yml.tmpl в harbor.yml</b></code>:</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">tar&nbsp;xzvf&nbsp;harbor-offline-installer-vX.Y.Z.tgz&nbsp;&amp;&amp;&nbsp;cd&nbsp;harbor</span><br />
<span class="f_CodeExample">cp&nbsp;harbor.yml.tmpl&nbsp;harbor.yml</span></p>
<h2 class="p_Heading2"><a id="complete-config-file" class="hmanchor"></a><span class="f_Heading2">Step 3: Fill in the configuration file harbor.yml</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" class="p_Normal">Fill in the variables in the <code><b>harbor.yml</b></code> file.</li></ol>
<p class="p_Normal">Set the domain (FQDN) or IP address in the <code><b>hostname</b></code> parameter, through which the registry will be accessible, for example, set the domain name <span style="font-weight: bold;">registry.example.com</span>.</p>
<ol style="list-style-type:upper-roman" start="2">
<li value="2" class="p_Normal">Determine the protocols through which the repository will be accessible.</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">Начало&nbsp;внимание</span></p>
<p class="p_Normal">If the registry should only be accessible via the HTTP protocol, comment out the parameters in the HTTPS section and set the <code><b>trivy.insecure</b></code> parameter to <code><b>true</b></code>.</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">Конец&nbsp;внимание</span></p>
<p class="p_Normal">In this article, the repository will be accessible via the HTTPS protocol, with redirection from HTTP to HTTPS. </p>
<p class="p_Normal">Port numbers for parameters <code><b>http.port</b></code> and <code><b>https.port</b></code>:</p>
<ul style="list-style-type:disc">
<li class="p_Normal">80 for HTTP;</li><li class="p_Normal">443 for HTTPS. </li></ul>
<p class="p_Normal">Specify the path to the open certificate file in the <code><b>https.certificate</b></code> parameter, and in <code><b>https.private_key</b></code> specify the path to the private key file.</p>
<ol style="list-style-type:upper-roman" start="3">
<li value="3" class="p_Normal">Set the password for the <span style="font-weight: bold;">admin</span> user in parameter <code><b>harbor_admin_password</b></code>. If necessary, change the path to the directory where the images will be stored in the <code><b>data_volume</b></code> parameter.</li></ol>
<p class="p_Normal"><a class="dropdown-toggle" style="font-style: normal; font-weight: normal; color: #000000; background-color: transparent; text-decoration: none;" href="javascript:HMToggle('toggle','TOGGLE0186A1')">Example of filling in configuration file parameters for installation within the article's scope</a></p>
<div id="TOGGLE0186A1" class="dropdown-toggle-body" style="text-align: left; text-indent: 0; line-height: 1.80; padding: 0 0 0 0; margin: 0 0 0 0;"><table style="border:none; border-spacing:0;">
<tr>
<td style="vertical-align:top; padding:0; border:none"><p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">#&nbsp;Configuration&nbsp;file&nbsp;of&nbsp;Harbor</span><br />
<span class="f_CodeExample">hostname:</span><span class="f_CodeExample" style="color: #ffffff;">&nbsp;</span><span class="f_CodeExample">registry.example.com</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">#&nbsp;http&nbsp;related&nbsp;config</span><br />
<span class="f_CodeExample">http:</span><br />
<span class="f_CodeExample" style="color: #ffffff;">&nbsp;&nbsp;</span><span class="f_CodeExample">#&nbsp;port&nbsp;for&nbsp;http,&nbsp;default&nbsp;is&nbsp;80.&nbsp;If&nbsp;https&nbsp;enabled,&nbsp;this&nbsp;port&nbsp;will&nbsp;redirect&nbsp;to&nbsp;https&nbsp;port</span><br />
<span class="f_CodeExample" style="color: #ffffff;">&nbsp;&nbsp;</span><span class="f_CodeExample">port:</span><span class="f_CodeExample" style="color: #ffffff;">&nbsp;</span><span class="f_CodeExample">80</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">#&nbsp;https&nbsp;related&nbsp;config</span><br />
<span class="f_CodeExample">https:</span><br />
<span class="f_CodeExample" style="color: #ffffff;">&nbsp;&nbsp;</span><span class="f_CodeExample">#&nbsp;https&nbsp;port&nbsp;for&nbsp;harbor,&nbsp;default&nbsp;is&nbsp;443</span><br />
<span class="f_CodeExample" style="color: #ffffff;">&nbsp;&nbsp;</span><span class="f_CodeExample">port:</span><span class="f_CodeExample" style="color: #ffffff;">&nbsp;</span><span class="f_CodeExample">443</span><br />
<span class="f_CodeExample" style="color: #ffffff;">&nbsp;&nbsp;</span><span class="f_CodeExample">#&nbsp;The&nbsp;path&nbsp;of&nbsp;cert&nbsp;and&nbsp;key&nbsp;files&nbsp;for&nbsp;nginx</span><br />
<span class="f_CodeExample" style="color: #ffffff;">&nbsp;&nbsp;</span><span class="f_CodeExample">certificate:</span><span class="f_CodeExample" style="color: #ffffff;">&nbsp;</span><span class="f_CodeExample">/your/certificate/path</span><br />
<span class="f_CodeExample" style="color: #ffffff;">&nbsp;&nbsp;</span><span class="f_CodeExample">private_key:</span><span class="f_CodeExample" style="color: #ffffff;">&nbsp;</span><span class="f_CodeExample">/your/private/key/path</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">#&nbsp;The&nbsp;initial&nbsp;password&nbsp;of&nbsp;Harbor&nbsp;admin</span><br />
<span class="f_CodeExample">harbor_admin_password:</span><span class="f_CodeExample" style="color: #ffffff;">&nbsp;</span><span class="f_CodeExample">Harbor12345</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">...</span></p>
</td>
</tr>
</table>
</div>
<ol style="list-style-type:upper-roman" start="4">
<li value="4" class="p_Normal">Configure other parameters according to your security policy and expected load.</li></ol>
<h2 class="p_Heading2"><a id="installing" class="hmanchor"></a><span class="f_Heading2">Step 4: Install Harbor</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" class="p_Normal">Install Harbor by executing the following command:</li></ol>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">sudo&nbsp;./install.sh</span></p>
<ol style="list-style-type:upper-roman" start="2">
<li value="2" class="p_CodeExample" style="white-space: normal; page-break-inside: auto;">Wait for the installation script to complete.</li></ol>
<ol style="list-style-type:upper-roman" start="3">
<li value="3" class="p_CodeExample" style="white-space: normal; page-break-inside: auto;"> Open a browser and go to the Harbor login page at <span style="font-weight: bold;">http://hostname</span> or <span style="font-weight: bold;">https://hostname</span>. The <code><b>hostname</b></code> parameter was specified during configuration file filling in the <code><b>harbor.yml</b></code><span class="f_CodeExample"> </span>confguration file on the <a href="installing-harbor.html" class="topiclink">fill in the configuration file</a> step.</li></ol>
<p class="p_Normal">In this example, the login page address for Harbor is <code><b>https://registry.example.com</b></code>. </p>
<ol style="list-style-type:upper-roman" start="4">
<li value="4" class="p_CodeExample" style="white-space: normal; page-break-inside: auto;">Log in with the username <span style="font-weight: bold;">admin</span> and the password set in the configuration file <code><b>harbor.yml</b></code><span class="f_CodeExample"> </span>in the <code><b>harbor_admin_password</b></code> parameter.</li></ol>
<p class="p_Normal" style="margin: 0 0 0 38px;"><img alt="login_harbor" title="login_harbor" width="414" height="435" style="margin:0;width:414px;height:435px;border:none" src="login_harbor.png"/></p>
<ol style="list-style-type:upper-roman" start="5">
<li value="5" class="p_Normal">The Harbor projects page opens.</li></ol>
<p class="p_Normal" style="margin: 0 0 0 38px;"><img alt="creating-new-project-harbor-1" width="1033" height="477" style="margin:0;width:1033px;height:477px;border:none" src="creating-new-project-harbor-1.png"/></p>
<p class="p_Normal">The Harbor private registry installation is complete.</p>
<div class="bottom-nav">
<a id="prev-link" class="topic__navi_prev" href="pgbouncer-installation.html">
<span class="bottom-nav__arrow bottom-nav__arrow--prev"></span> <span
class="bottom-nav__link">pgbouncer-installation.html</span>
</a>
<a id="next-link" class="topic__navi_next" href="downloadin-images-elma365.html">
<span class="bottom-nav__link">downloadin-images-elma365.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>
<script type="text/javascript">
HMInitToggle('TOGGLE0186A1','hm.type','dropdown','hm.state','0');
</script>
</body>
</html>