Вы можете использовать имеющийся готовый сервер, в том числе с другими контейнерами приложений. Для вашего удобства подготовлена базовая инструкция установки ОС Ubuntu Server [Установка ОС Ubuntu Server 22.04 LTS].

Docker: 23.0.4 или выше
Docker Compose: v2.20.3 или выше

Также в рамках скрипта устанавливается Cockpit для упрощения монтирования накопителей и выполнения прочих действий по администрированию сервера.

ВАЖНО

Для работы скрипта требуется доступ в интернет, так как в коде «зашиты» ссылки на дистрибутивы из публичных репозиториев. Рекомендуется выполнять первичную настройку сервера при наличии доступа в интернет. При невозможности подключения к сети рекомендуем изменить пути загрузки пакетов на локальные или самостоятельно выполнить установку требуемых пакетов.

Даже в рамках одного семейства ОС на различных версиях инсталляция может выполняться немного по-разному. Код скрипта оптимизирован для целевых версий ОС:

• Ubuntu Server 20.04 LTS, Ubuntu Server 22.04 LTS
• Astra Linux Special Edition 1.7, 1.8

Вы можете запросить готовый файл скрипта у специалистов компании ИТРИУМ. Также вы можете сформировать его самостоятельно по инструкции ниже.

#!/bin/bash
set -e

# debian packages
add_docker_debian_apt_repo() {
	# for ubuntu or debian adding actual repo based on os-release
	# for astra adding fixed repo for debian buster
	. /etc/os-release
	lsb_dist=""
	lsb_version=""
	case $ID in
		"debian" | "ubuntu")
			lsb_dist="$ID"
			lsb_version=$(lsb_release -cs)
		;;
		"astra")
			lsb_dist="debian"
			lsb_version="buster"
		;;
		*)
			# this should not be the case
			exit 1
		;;
	esac
	DOCKER_APT_REPO="deb [arch=amd64] https://download.docker.com/linux/$lsb_dist $lsb_version stable"
	echo "[docker] adding repo $DOCKER_APT_REPO to /etc/apt/sources.list"

	COMMENT_TEXT="repo to install docker appended by neyross-platform installer"
	if [ $(grep -c "$COMMENT_TEXT" /etc/apt/sources.list) -eq 1 ]
	then
		echo "[docker] repo to install docker already added to sources.list by previous run of installer; do nothing"
	else
		echo "[docker] this is first run; adding repo to install docker..."
		sudo tee -a /etc/apt/sources.list > /dev/null <<EOT

# $COMMENT_TEXT

# repo to install docker
$DOCKER_APT_REPO
EOT
	fi
}


ensure_docker_debian() {
	if command -v docker > /dev/null 2>&1; then
		echo "[docker] already installed, do nothing"
	else
		# standart way with software-properties-common and apt-add-repository not working on Astra
		echo "[docker] not installed, installing manually, updating apt..."
		sudo apt update
		echo "[docker] installing additional packages..."
		sudo apt install -y apt-transport-https ca-certificates curl gnupg2
		echo "[docker] adding gpg key"
		curl -fsSL https://download.docker.com/linux/debian/gpg | sudo apt-key add -
		echo "[docker] adding docker apt repo..."
		add_docker_debian_apt_repo
		echo "[docker] running update..."
		sudo apt update
		echo "[docker] installing docker-ce..."
		sudo apt install -y docker-ce
		echo "[docker] done; starting and enabling docker service"
		sudo systemctl start docker
		sudo systemctl enable docker
	fi
	docker -v
	docker compose version
}

ensure_cockpit_debian() {
	if command -v cockpit-bridge > /dev/null 2>&1; then
		echo "[cockpit] already installed, do nothing"
	else
		echo "[cockpit] not found; installing it with plugins"
		sudo apt update
		sudo apt install -y cockpit cockpit-system cockpit-bridge
		echo "[cockpit] done; preparing cockpit.conf"
		COCKPIT_CONF_CONTENT=$(cat <<-END

[WebService]
AllowUnencrypted = true
END
)
		echo "$COCKPIT_CONF_CONTENT" > /etc/cockpit/cockpit.conf
		sudo chgrp cockpit-ws /etc/cockpit/cockpit.conf
		echo "[cockpit] done; enabling all network interfaces for cockpit JIC"
		GLOBALLY_MANAGED_DEVICES_CONTENT=$(cat <<-END
[keyfile]
unmanaged-devices=none
END
)
		echo "$GLOBALLY_MANAGED_DEVICES_CONTENT" > /etc/NetworkManager/conf.d/10-globally-managed-devices.conf
		sudo systemctl restart NetworkManager
		echo "done; starting and enabling cockpit service"
		sudo systemctl start cockpit
		sudo systemctl enable cockpit
		echo "[cockpit] done with cockpit"
	fi
}

install_debian_packages() {
echo "installing ubuntu \ debian packages;"
ensure_docker_debian
ensure_cockpit_debian
}

# end debian packages

# astra packages
ensure_astra_repositories() {
	COMMENT_TEXT="added by neyross-platform installer"
	if [ $(grep -c "$COMMENT_TEXT" /etc/apt/sources.list) -eq 1 ]
	then
		echo "repos already added to sources.list by previous run of installer; do nothing"
	else
		echo "this is first run; adding repos for extended astra..."
		sudo tee -a /etc/apt/sources.list > /dev/null <<EOT
# $COMMENT_TEXT
# all astra repos
deb https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-main/ 1.7_x86-64 main contrib non-free
deb https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-update/ 1.7_x86-64 main contrib non-free
deb https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-base/ 1.7_x86-64 main contrib non-free
deb https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/ 1.7_x86-64 main contrib non-free
deb https://dl.astralinux.ru/astra/stable/1.7_x86-64/repository-extended/ 1.7_x86-64 astra-ce backports

EOT
	fi
}

install_astra_packages() {
	echo "installing astra packages;"
	ensure_astra_repositories
	ensure_docker_debian
	ensure_cockpit_debian
}
# end astra packages

# rhel packages
ensure_docker_rhel() {
	if command -v docker > /dev/null 2>&1; then
		echo "docker already installed, do nothing"
	else
		echo "docker not installed, using script from get.docker.com..."
		curl -fsSL https://get.docker.com -o /tmp/install-docker.sh
		sh /tmp/install-docker.sh
		echo "done installing docker; starting and enabling systemd service..."
		systemctl start docker
		systemctl enable docker
		echo "done with docker"
	fi
	docker -v
	docker compose version
}
ensure_cockpit_rhel() {
	if command -v cockpit-bridge > /dev/null 2>&1; then
		echo "[cockpit] already installed, do nothing"
	else
		echo "[cockpit] not found; installing it with plugins"
		sudo yum update
		sudo yum install cockpit
		echo "[cockpit] done; preparing cockpit.conf"
		COCKPIT_CONF_CONTENT=$(cat <<-END
[WebService]
AllowUnencrypted = true
END
)
		echo "$COCKPIT_CONF_CONTENT" > /etc/cockpit/cockpit.conf
		sudo chgrp cockpit-ws /etc/cockpit/cockpit.conf
		echo "[cockpit] done; enabling all network interfaces for cockpit JIC"
		GLOBALLY_MANAGED_DEVICES_CONTENT=$(cat <<-END
[keyfile]
unmanaged-devices=none
END
)
		echo "$GLOBALLY_MANAGED_DEVICES_CONTENT" > /etc/NetworkManager/conf.d/10-globally-managed-devices.conf
		sudo systemctl restart NetworkManager
		echo "done; starting and enabling cockpit service"
		sudo systemctl enable --now cockpit.socket
		sudo systemctl start cockpit
		sudo systemctl enable cockpit
		echo "done; enabling FW rules"
		sudo firewall-cmd --permanent --add-service=cockpit
		sudo firewall-cmd --reload
		echo "[cockpit] done with cockpit"
	fi
}

# NOT TESTED YET
install_rhel_packages() {
	echo "installing RHEL packages"
	ensure_docker_rhel
	ensure_cockpit_rhel
}
# end rhel packages

check_docker_version() {
	required_version="23.0.0"

	if ! command -v docker &>/dev/null; then
		echo "docker is not installed" >&2
		return
	fi

	current_version=$(docker --version | awk '{print $3}')

	if [[ "$(printf '%s\n' "$required_version" "$current_version" | sort -V | head -n1)" != "$required_version" ]]; then
		echo "the current version of Docker (${current_version}) is less than the required version (${required_version})." >&2
	exit 1
	fi
}

install_packages() {
	if [ -f "/etc/os-release" ]; then
		. /etc/os-release
		echo "checking for docker availability"
		check_docker_version
		echo "installing system packages; OS ID is $ID, OS ID_LIKE is $ID_LIKE"
		case $ID in
			"debian" | "ubuntu")
				install_debian_packages
			;;
			"astra")
				install_astra_packages
			;;
			"centos" | "rhel" | "fedora")
				install_rhel_packages
			;;
			# Add cases for other distributions and call the appropriate installation functions
			*)
				echo "Unsupported distribution, please contact Itrium for support in adding your distribution. Please provide output of /etc/os-release and /etc/lsb_release"
				exit 1
			;;
		esac
	else
		echo "Unsupported Linux distribution"
		exit 1
	fi
}

# Make sure we are root or we sudo'd
[ $(id -u) != "0" ] && { echo "Error: You must be root to run this script"; exit 1; }

echo "Hello, this script prepares OS to Neyross Platform (installs docker and cockpit)"
install_packages
echo "done, ready to install neyross-platform-docker / neyross-start"

exit 0

ВАЖНО

При работе в ОС семейства Windows файл по умолчанию создаётся в кодировке Windows (CR LF), такой формат не распознаётся корректно в среде Linux, возникают ошибки запуска. Рекомендуем воспользоваться свободно распространяемым приложение Notepad++.

Порядок действий:

1. Создать новый пустой файл.
2. Вставить скопированный код скрипта.
3. Выполнить команду Правка → Формат конца строк → Преобразовать в Unix.
4. Выполнить команду Файл → Сохранить как. Задать имя файла латиницей. Указать тип файла: «Unix script file».

Вы также можете обратиться к специалистам компании ИТРИУМ, мы вышлем подготовленный файл.

Поместите файл pscp.exe из дистрибутива Putty в папку со скриптом инсталляции и из интерфейса командной строки ОС Windows выполните:

pscp.exe prepare-os-docker.sh user@10.1.29.38:/home/user/

Где:

• prepare-os-docker.sh —  скрипт подготовки ОС;
• user — имя суперпользователя в ОС;
• 10.1.29.38 — IP-адрес сервера;
• /home/user/ — путь к целевой папке.

sudo bash prepare-os-docker.sh

The repository '[путь к дистрибутиву]' no longer has a Release file.

 sudo nano /etc/apt/sources.list

docker -v
docker compose version

ВАЖНО

При установке Docker вручную не используйте пакеты snap, используйте APT! Если ранее был установлен Docker с помощью snap или неподдерживаемой версии, рекомендуем предварительно удалить Docker.