Skip to content
This repository was archived by the owner on Apr 23, 2025. It is now read-only.

Commit 479ea05

Browse files
author
olevole
committed
update docs
1 parent 08f6db3 commit 479ea05

9 files changed

+114
-10
lines changed

de/installing_cbsd.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ <h2><a name="preparing">Preparing the system and installing <strong>CBSD</strong
5151
</pre>
5252
<p>c) create a <strong>CBSD</strong> user (when installing from ports or pkg's this is unnecessary):</p>
5353
<pre class="brush:bash;ruler:true;">
54-
% pw useradd cbsd -s /bin/sh -d /nonexistent -c "cbsd user"
54+
% pw useradd cbsd -u 150 -s /bin/sh -d /nonexistent -c "cbsd user"
5555
</pre>
5656
<p>d) create links of the rc.d scripts to start <strong>CBSD</strong> at system startup and create link to bsdconfig module (when installing from ports and pkg's it is unnecessary):</p>
5757
<pre class="brush:bash;ruler:true;">

en/cbsd_additional.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -222,7 +222,7 @@ <h2><a name="hier">A brief summary of the filesystem hierarchy <strong>CBSD</str
222222
<div class="block">
223223
<table class="images">
224224
<tr><td class="bg-gray">${workdir}/.rssh/</td><td>This directory stores the private keys of remote nodes. The files are added and removed via the command <strong>cbsd node</strong></td></tr>
225-
<tr><td class="bg-gray">${workdir}/.ssh</td><td>This directory stores the private and public keys of the nodes. The directory is created during initialization with the command <strong><em>cbsd initenv</em></strong>. This is also where the public key comes from when the command <strong>cbsd node mode=add</strong> is issued to copy the pub key to a remote host. The Key file name is the md5 sum of the nodename.</td></tr>
225+
<tr><td class="bg-gray">${workdir}/.ssh</td><td>This directory stores the private and public keys of the nodes. The directory is created during initialization with the command <strong><em>cbsd initenv</em></strong>. This is also where the public key comes from when the command <strong>cbsd node mode=add</strong> is issued to copy the pub key to a remote host. The Key file name is the md5 sum of the nodename. In addition, this key pair is used by default when working with cloud images of virtual machines, For example, in the operations 'cbsd bexec, cbsd bscp, cbsd blogin'</td></tr>
226226
<tr><td class="bg-gray">${workdir}/basejail</td><td>This directory is used to store the bases and kernels for FreeBSD that are used when creating baserw=0 jails. These are generated via cbsd buildworld/buildkernel, cbsd installworld/installkernel, or cbsd repo action=get sources=base/kernel)</td></tr>
227227
<tr><td class="bg-gray">${workdir}/etc</td><td>Configuration files needed to run <strong>CBSD</strong></td></tr>
228228
<tr><td class="bg-gray">${workdir}/export</td><td>The default directory that will be stored in a file exported by the jail (a cbsd jexport jname=$jname, this directory will file $jname.img)</td></tr>

en/installing_cbsd.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ <h2><a name="preparing">Preparing the system and installing <strong>CBSD</strong
5151
</pre>
5252
<p>c) create a <strong>CBSD</strong> user (when installing from ports or pkg's this is unnecessary):</p>
5353
<pre class="brush:bash;ruler:true;">
54-
% pw useradd cbsd -s /bin/sh -d /nonexistent -c "cbsd user"
54+
% pw useradd cbsd -u 150 -s /bin/sh -d /nonexistent -c "cbsd user"
5555
</pre>
5656
<p>d) create links of the rc.d scripts to start <strong>CBSD</strong> at system startup and create link to bsdconfig module (when installing from ports and pkg's it is unnecessary):</p>
5757
<pre class="brush:bash;ruler:true;">

en/news.html

+17
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,23 @@ <h2><a name="development">&nbsp;Development</a></h2>
1212
<p><em>If&nbsp;you want to&nbsp;experiment with the next version of&nbsp;<strong>CBSD</strong>, use <strong>git clone https://github.com/cbsd/cbsd.git</strong> for <strong>/usr/local/cbsd</strong></em></p>
1313
</div>
1414
<h2><a name="release">Releases</a></h2>
15+
<div class="block">
16+
<p><strong>13.1.18</strong>&nbsp;&mdash; 2022-12-06</p>
17+
<ul>
18+
<li>debootstrap exec fixes (reported by @lbartoletti via Telegram);</li>
19+
<li>bhyve: new cloud image: Oracle 9.1;</li>
20+
<li>bhyve: new cloud image: FreeBSD 12.4 (ufs/zfs);</li>
21+
<li>initenv: add PRE_CBSD_CMD_PATH + POST_CBSD_CMD_PATH variables;</li>
22+
<ul>
23+
</div>
24+
<div class="block">
25+
<p><strong>13.1.17</strong>&nbsp;&mdash; 2022-11-29</p>
26+
<ul>
27+
<li>bhyve: new cloud images: AlmaLinux 9.1, Rocky 9.1, Fedora 37;</li>
28+
<li>jail: use devfs_ruleset=5 by default for vnet;</li>
29+
<li>virtual disks: ZFS: always reserve by default;</li>
30+
<ul>
31+
</div>
1532
<div class="block">
1633
<p><strong>13.1.16</strong>&nbsp;&mdash; 2022-11-06</p>
1734
<ul>

rss.xml

+27
Original file line numberDiff line numberDiff line change
@@ -1603,5 +1603,32 @@
16031603
<guid>CBSD 13.1.16 available</guid>
16041604
<pubDate>Sun, 06 Nov 2022 01:00:00 +0000</pubDate>
16051605
</item>
1606+
<item>
1607+
<title>CBSD 13.1.17 release</title>
1608+
<description>CBSD 13.1.17 release&lt;br /&gt;
1609+
&lt;br /&gt;
1610+
&lt;br /&gt;
1611+
bhyve: new cloud images: AlmaLinux 9.1, Rocky 9.1, Fedora 37;&lt;br /&gt;
1612+
jail: use devfs_ruleset=5 by default for vnet;&lt;br /&gt;
1613+
virtual disks: ZFS: always reserve by default;&lt;br /&gt;
1614+
</description>
1615+
<link>https://www.bsdstore.ru</link>
1616+
<guid>CBSD 13.1.17 available</guid>
1617+
<pubDate>Tue, 29 Nov 2022 01:00:00 +0000</pubDate>
1618+
</item>
1619+
<item>
1620+
<title>CBSD 13.1.18 release</title>
1621+
<description>CBSD 13.1.18 release&lt;br /&gt;
1622+
&lt;br /&gt;
1623+
&lt;br /&gt;
1624+
debootstrap exec fixes (reported by @lbartoletti via Telegram)&lt;br /&gt;
1625+
bhyve: new cloud image: Oracle 9.1&lt;br /&gt;
1626+
bhyve: new cloud image: FreeBSD 12.4 (ufs/zfs)&lt;br /&gt;
1627+
initenv: add PRE_CBSD_CMD_PATH + POST_CBSD_CMD_PATH variables&lt;br /&gt;
1628+
</description>
1629+
<link>https://www.bsdstore.ru</link>
1630+
<guid>CBSD 13.1.18 available</guid>
1631+
<pubDate>Tue, 06 Dec 2022 01:00:00 +0000</pubDate>
1632+
</item>
16061633
</channel>
16071634
</rss>

ru/cbsd_additional.html

+22-6
Original file line numberDiff line numberDiff line change
@@ -101,21 +101,37 @@ <h2><a name="jnameasmask">Мульти-операции с использова
101101
<h2><a name="hier">Иерархия <strong>CBSD</strong> каталога</a></h2>
102102
<div class="block">
103103
<table class="images">
104-
<tr><td class="bg-gray">${workdir}/.rssh/</td><td>Каталог для хранения приватных ключей удаленных нод. Файлы добавляются и удаляются через команду <strong>cbsd node</strong></td></tr>
105-
<tr><td class="bg-gray">${workdir}/.ssh</td><td>Здесь хранится приватный и публичный ключ непосредственно данной ноды. Формируется на этапе инициализации при команде cbsd initenv. Именно отсюда будут забирать публичный ключ удаленные хосты по команде cbsd node mode=add. Имя, заданное на этапе initenv в вопросе nodename должен совпадать с написанием имени в аргументе node= при команде cbsd node mode=add. Имя файла ключа является md5 суммой от этого имени.</td></tr>
104+
<tr><td class="bg-gray"><strong>${workdir}/.rssh/</strong></td><td>Каталог для хранения приватных ключей удаленных нод. Файлы добавляются и удаляются через команду <strong>cbsd node</strong></td></tr>
105+
<tr><td class="bg-gray"><strong>${workdir}/.ssh/</strong></td><td>Здесь хранится приватный и публичный ключ непосредственно данной ноды. Формируется на этапе инициализации при команде cbsd initenv. Именно отсюда будут забирать публичный ключ удаленные хосты по команде cbsd node mode=add. Имя, заданное на этапе initenv в вопросе nodename должен совпадать с написанием имени в аргументе node= при команде cbsd node mode=add. Имя файла ключа является md5 суммой от этого имени. Кроме этого, эта пара ключей используется по-умолчанию при работе с облачными образами виртуальных машин, например, в операциях 'cbsd bexec, cbsd bscp, cbsd blogin'</td></tr>
106106
<tr><td class="bg-gray">${workdir}/basejail</td><td>Здесь хранятся готовые к использованию базы и ядра FreeBSD (результат cbsd buildworld/buildkernel, cbsd installworld/installkernel или cbsd repo action=get sources=base/kernel)</td></tr>
107107
<tr><td class="bg-gray">${workdir}/etc</td><td>Конфигурационные файлы, необходимые для работы cbsd</td></tr>
108108
<tr><td class="bg-gray">${workdir}/export</td><td>Каталог по-умолчанию, в который будет сохраняться экспортированная в файл клетка (при команде cbsd jexport jname=$jname, в этом каталоге появится файл $jname.img)</td></tr>
109109
<tr><td class="bg-gray">${workdir}/import</td><td>Каталог по-умолчанию, из которого будет импортирован jail (при cbsd jimport jname=$jname, будет развернута клета $jname)</td></tr>
110110
<tr><td class="bg-gray">${workdir}/jails</td><td>В данном каталоге находятся точка монтирования корня для jail-ов, использующих baserw=0.</td></tr>
111-
<tr><td class="bg-gray">${workdir}/jails-data</td><td>В этом каталоге лежат данные клетки. Именно этим местам необходим бекап для сохранности данных клетки. Также, если клетка использует baserw=1, эти каталоги являются корнем клетки при ее старте</td></tr>
112-
<tr><td class="bg-gray">${workdir}/jails-fstab</td><td>fstab файл для клеток. Синтаксис обычный для FreeBSD за тем лишь исключением, что путь к точке монтирования пишется относительно корня jail (запись <strong>/usr/ports /usr/ports nullfs rw 0 0</strong> в файле fstab.$jname означает, что из мастер-ноды каталог /usr/ports будет примонтирован при запуске в ${workdir}/jails/$jname/usr/ports)</td></tr>
113-
<tr><td class="bg-gray">${workdir}/jails-system</td><td>Этот каталог может содержать какие-то вспомогательные скрипты, относящиеся к клетке (например скрипты-wizard-ы для настройки, конфигураторы и пр) а также, сохраняется трафик клетки, если используется ipfw и ее описание. Данный каталог учавствует при jimport/jexport операциях и мигрировании клеток</td></tr>
111+
<tr><td class="bg-gray"><font style="color:RED"><strong>${workdir}/jails-data</strong></font></td><td>В этом каталоге лежат данные клетки или виртуальные диски виртуальной машины. Именно этим местам необходим бекап для сохранности данных клетки. Также, если клетка использует baserw=1, эти каталоги являются корнем клетки при ее старте. <font style="color:RED">Обратите внимание!</font> При использовании ZVOL, фактически диски расположены в ZVOL и из каталога jails-data идут лишь символические ссылки - учитывайте это при планировании резервного копирования/DR !. Этот каталог (или VOLUME, на которые указывают симполические ссылки) подлежит резервному копированию, если вы хотите восставить данные своих виртуальных окружений в случае сбоев.</td></tr>
112+
<tr><td class="bg-gray"><strong>${workdir}/jails-fstab</strong></td><td>fstab файл для клеток. Синтаксис обычный для FreeBSD за тем лишь исключением, что путь к точке монтирования пишется относительно корня jail (запись <strong>/usr/ports /usr/ports nullfs rw 0 0</strong> в файле fstab.$jname означает, что из мастер-ноды каталог /usr/ports будет примонтирован при запуске в ${workdir}/jails/$jname/usr/ports)</td></tr>
113+
<tr><td class="bg-gray"><strong>${workdir}/jails-system</strong></td><td>Этот каталог может содержать какие-то вспомогательные скрипты, относящиеся к клетке (например скрипты-wizard-ы для настройки, вспомогательная база данных окружения, конфигураторы и пр) а также, сохраняется трафик клетки, если используется ipfw и ее описание. Данный каталог учавствует при jimport/jexport операциях и мигрировании клеток. Этот каталог подлежит резервному копированию, если вы хотите восставить работу <strong>CBSD</strong> при сбоях.</td></tr>
114+
<tr><td class="bg-gray">${workdir}/vm</td><td>Каталог специфичный для ZFS-based инсталляций при использовании виртуальных машин. Выполняет те же функции, что каталог jails-data, при этом каталог в jails-data становится символической ссылкой на каталоги vm/</td></tr>
114115
<tr><td class="bg-gray">${workdir}/var</td><td>Каталог который содержит различную системную информацию cbsd. Например, в ${workdir}/var/db находится инвентаризация локальных и удаленных нод если они были добавлены</td></tr>
116+
<tr><td class="bg-gray"><strong>${workdir}/var/db</strong></td><td>Здесь размещается основная и самая главная SQLite3 база CBSD, на нее указывает симполическая ссылка <strong>local.sqlite</strong>. Этот каталог подлежит резервному копированию, если вы хотите восставить работу <strong>CBSD</strong> при сбоях.</td></tr>
115117
<tr><td class="bg-gray">/usr/local/cbsd</td><td>Копия оригинальных файлов <strong>CBSD</strong> устанавливаемая портом. Также, содержит рабочие скрипты в каталоге <strong>sudoexec</strong></td></tr>
116118
</table>
119+
120+
<p>Например, для ручного переноса контейнера из структуры <strong>CBSD</strong> вам потребуется файл, на который указывает символическая ссылка ~cbsd/var/db/local.sqlite. Ее содержимое (таблица jails, bhyve, xen ..) отвечает за список зарегистрированных окружений, например:</p>
121+
<pre>
122+
sqlite3 ~cbsd/var/db/local.sqlite "SELECT * from jails";
123+
sqlite3 ~cbsd/var/db/local.sqlite ".schema jails";
124+
sqlite3 ~cbsd/var/db/local.sqlite ".tables";
125+
sqlite3 ~cbsd/var/db/local.sqlite ".dump";
126+
</pre>
127+
<p>Также, вам необходим rootfs контейнера в каталоге ~cbsd/jails-data/JAILNAME-data</p>
128+
<p>Что касается виртуальных машин, вам необходимо дополнительно проверить, являются ли диски виртуальных машин ZVOL-based ( zfs list | egrep "dsk[0-9]+.vhd" ), а также, обязательно скопировать ~cbsd/jails-system/ENVNAME/ , где находятся настройки виртуальной машины в файле local.sqlite:</p>
129+
<pre>
130+
sqlite3 ~cbsd/jails-system/VMNAME/local.sqlite "SELECT * from settings";
131+
sqlite3 ~cbsd/jails-system/VMNAME/local.sqlite ".tables";
132+
sqlite3 ~cbsd/jails-system/VMNAME/local.sqlite ".dump";
133+
</pre>
117134
</div>
118-
119135
<h2><a name="traffic">Подсчет трафика jail</a></h2>
120136
<div class="block">
121137
<p>В данный момент, для подсчета трафика jail используются правила <strong>count</strong> у фильтра <strong>ipfw</strong>. <strong>CBSD</strong> назначает для счетчиков номера правил из диапазона <strong>99&nbsp;— 2000</strong> (можно изменить в cbsd.conf). Поэтому будьте внимательны и следите за тем, чтобы ваши правила IPFW следовали после указанного диапазона.</p>

ru/installing_cbsd.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ <h2><a name="preparing">Установка и подготовка к работ
4949
</pre>
5050
<p>c) Необходимо создать пользователя cbsd (при установке из портов или пакета, этот шаг не нужен)</p>
5151
<pre class="brush:bash;ruler:true;">
52-
% pw useradd cbsd -s /bin/sh -d /nonexistent -c "cbsd user"
52+
% pw useradd cbsd -u 150 -s /bin/sh -d /nonexistent -c "cbsd user"
5353
</pre>
5454
<p>d) создайте ссылки rc.d скриптов для запуска cbsd при старте системы и ссылку на модуль bsdconfig (при установке из портов этого делать ненужно):</p>
5555
<pre class="brush:bash;ruler:true;">

ru/news.html

+17
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,23 @@ <h2><a name="development">&nbsp;Разработка</a></h2>
1111
<p><em>Если вы&nbsp;хотите поэкспериментировать со&nbsp;следующей версией <strong>CBSD</strong>, используйте <strong>git clone https://github.com/cbsd/cbsd.git</strong> для <strong>/usr/local/cbsd</strong></em></p>
1212
</div>
1313
<h2><a name="release">Релизы</a></h2>
14+
<div class="block">
15+
<p><strong>13.1.18</strong>&nbsp;&mdash; 2022-12-06</p>
16+
<ul>
17+
<li>debootstrap exec fixes (reported by @lbartoletti via Telegram);</li>
18+
<li>bhyve: new cloud image: Oracle 9.1;</li>
19+
<li>bhyve: new cloud image: FreeBSD 12.4 (ufs/zfs);</li>
20+
<li>initenv: add PRE_CBSD_CMD_PATH + POST_CBSD_CMD_PATH variables;</li>
21+
<ul>
22+
</div>
23+
<div class="block">
24+
<p><strong>13.1.17</strong>&nbsp;&mdash; 2022-11-29</p>
25+
<ul>
26+
<li>bhyve: new cloud images: AlmaLinux 9.1, Rocky 9.1, Fedora 37;</li>
27+
<li>jail: use devfs_ruleset=5 by default for vnet;</li>
28+
<li>virtual disks: ZFS: always reserve by default;</li>
29+
<ul>
30+
</div>
1431
<div class="block">
1532
<p><strong>13.1.16</strong>&nbsp;&mdash; 2022-11-06</p>
1633
<ul>

0 commit comments

Comments
 (0)