WebApps (Уеб приложения)

WebApps платформата е гъвкава система за управление на процеси, работещи във фонов режим. Тя позволява стартирането и използването на уеб приложения, които работят като сървъри със собствена мрежа, във фонов режим на хостинг акаунта. Такива уеб приложения обикновено изискват директна обработка на заявки. Има много приложения, които може да имат подобни изисквания. Например Node.js приложенията обикновено изискват собствен уеб сървър за обработка на входящи заявки, както и повечето уеб приложения, писани на Python. WebApps платформата не е ограничена за използването само на Node.js или Python приложения. Тя поддържа всякакви приложения, които трябва да обработват мрежови заявки. Например следният код показва прост уеб сървър, които се настройва само с два реда: #!/bin/sh response="${2:-"OK"}" while { echo -ne "HTTP/1.1 200 OK\r\nContent-Length: ${#response}\r\n\r\n$response"; } | nc -l -p "$1"; do printf "\n"; done В тази статия ще покажем как да създадете WebApps проект, който да подкара този уеб сървър. Важно: Показаният уеб сървър не е предназначен за работна среда, така че съветваме да не го използвате. Той е даден като пример за демонстрация на възможностите на WebApps платформата. Подготовка За да използвате уеб приложения, трябва да проверите и настроите Вашия акаунт за следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да се свържете с нас за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Създаване на уеб сървъра Влезте в акаунта си чрез SSH, за да създадете и настроите приложението. За създаване на директория, която да съхранява файловете на проекта, използвайте тази команда: webapps_project="shell_web_server_demo" webapps_project_dir="/home/$USER/private/$webapps_project" mkdir -pv "$webapps_project_dir/sureapp" Използвайте следната команда, за да създадете файл с име "webserver.sh", съдържащ кода за примерния уеб сървър: cat <<WEBSERVER_SH > "$webapps_project_dir/webserver.sh" #!/bin/sh response="\${2:-"OK"}" while { echo -ne "HTTP/1.1 200 OK\r\nContent-Length: \${#response}\r\n\r\n\$response"; } | nc -l -p "\$1"; do printf "\n"; done WEBSERVER_SH chmod 0700 "$webapps_project_dir/webserver.sh" Създаване на WebApps проект Има два начина за създаване на WebApps проект - чрез раздел "Уеб приложения" на Контролния панел или чрез "sureapp" CLI инструмента чрез SSH. Използване на раздел "WebApps" на Контролния панел Създайте ново уеб приложение чрез раздел "Уеб приложения" във Вашия Контролен панел, използвайки следните данни: "Платформа" - изберете "Custom". "Име" - въведете желаното от Вас име за уеб приложението (напр. "shell_web_server_demo"). "Домейн", "Поддомейн" и "Уеб път за достъп" - изберете адреса, на който желаете уеб приложението да бъде достъпно (напр. "example.com" за домейн, "www" за поддомейн и "/" за уеб път за достъп ще направи уеб приложението достъпно на "www.example.com/"). Важно е да се спомене, че уеб пътят за достъп не е необходимо да съществува на акаунта, защото той се генерира автоматично от платформата за уеб приложения. "Порт" - портът на уеб приложението се дава служебно и не подлежи на избор. След създаване на уеб приложението можете да видите назначения порт от платформата в списка с уеб приложения. "Директория на приложението" - директорията, в която се намират файловете на уеб приложението. Тук трябва да попълните името на директорията, която сте създали в първата стъпка (напр. "/private/shell_web_server_demo/sureapp"). Платформата вече ще е запазила определен порт за проекта Ви, който можете да видите в колоната "Порт" в списъка с приложения. Ще използваме този порт в стартовата команда на проекта. За целта кликнете на бутона с иконка на молив () до Вашия проект ("shell_web_server_demo"). Стартовата команда трябва да изглежда по този начин, като в нея трябва да замените "example" с потребителското име на Вашия хостинг акаунт и "6086" с порта на Вашия проект: /home/example/private/shell_web_server_demo/webserver.sh 6086 'Hello World' Натиснете бутона "Промени", за да запазите промените. Използване на "sureapp" CLI инструмента чрез SSH Ако предпочитате да използвате командния ред за управление на Вашия проект, тогава "sureapp" е инструментът за Вас. За създаване на проекта използвайте следната команда: sureapp project create \ --engine "custom" \ --engine-version "-" \ --release-dir "$webapps_project_dir/sureapp" \ "$webapps_project" sleep 10 # Some time is needed for the project to be saved Със следната команда се настройва използването на TCP порта, който е запазен за проекта от WebApps платформата: webapps_project_port="$(sureapp project list | grep "$webapps_project" | awk '{print $5}')" sureapp project modify \ --start-cmd "$webapps_project_dir/webserver.sh '$webapps_project_port' 'Hello World'" \ "$webapps_project" Последната стъпка е да настроите адреса, на който да е достъпен проектът. Можете да направите това чрез раздел "Уеб приложения" на хостинг Контролния панел, като кликнете на бутона с иконка на молив () до Вашия проект ("shell_web_server_demo"), използвайки полетата "Домейн", "Поддомейн" и "Уеб път за достъп". Натиснете бутона "Промени", за да запазите промените. Стартиране на WebApps проект Последно трябва да стартирате проекта, като натиснете бутона "Включи", който е с иконка на червен кръг ().Вашият нов уеб сървър ще се стартира и поддържа автоматично от WebApps платформата. HTTPS криптиране Важно е да споменем, че криптирането на връзката се извършва автоматично от WebApps платформата. Тоест Вашия WebApps проект ще работи по HTTPS, дори ако самото уеб приложение няма поддръжка за HTTPS, какъвто е случая с дадения за пример уеб сървър. Това се случва автоматично за всеки проект. Не е задължително да активирате връзките по HTTPS за Вашето приложение, ако то ги поддържа. Връзката между WebApps платформата и Вашия проект се осъществява локално и криптирано, така че връзките между Вашите посетители и WebApps платформата, стояща пред Вашето приложение, ще са криптирани от нашите сървъри. Уеб приложения

Командата "sureapp" е мощен CLI (command-line interface) инструмент, който позволява създаването и управлението на уеб приложенията във Вашия акаунт. За да използвате "sureapp" инструмента, трябва да се свържете с акаунта си чрез SSH. Можете да откриете информация за установяването на SSH връзка с Вашия акаунт е налична в раздел "SSH" на нашата документация. Тук са някои от функционалностите, поддържани от инструмента "sureapp": Инструкции за употреба Създаване на уеб приложение Влизане в конзолата на уеб приложение Управление на уеб приложение Промяна на настройките на уеб приложение Промяна на състоянието на уеб приложение Управление на променливи на средата на уеб приложение Преглеждане на настройките на уеб приложение Преглеждане на логовете на уеб приложение Изтриване на уеб приложение Управление на супервайзора на уеб приложения Важно: Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да се свържете с нашия екип за повече информация. Инструкции за употреба Ако използвате командата "sureapp" без никакви аргументи, ще се покаже списък с нейните подкоманди. За да видите инструкциите за употреба за определена команда и нейните подкоманди, използвайте следната команда, като не забравяйте да заместите "command" с командата, за която искате да научите повече: sureapp help command По-долу можете да откриете списък с наличните команди за "sureapp" CLI инструмента: project - позволява Ви да създавате, променяте, изтривате и виждате всички уеб приложения. service - дава Ви възможност да виждате и управлявате състоянието на уеб приложения. supervisor - позволява Ви да управлявате supervisor услугата. meta - показва мета информация. log - показва списък с логовете и позволява тяхното преглеждане. env - позволява управлението на променливи на средата на уеб приложения. Ако желаете да видите подкомандите и помощна информация за командата "sureapp project", използвайте командата: sureapp help project За да видите инструкции за употреба на командата "sureapp project create", трябва да използвате тази команда: sureapp help project create Създаване на уеб приложение Уеб приложенията могат да се създават през раздел "Уеб приложения" на Контролния панел. По този начин можете да конфигурирате всички задължителни настройки чрез визуален интерфейс. Ако все пак предпочитате да използвате команден ред, можете да използвате "sureapp" CLI инструмента за създаване на уеб приложения и командата "sureapp project create". За да създадете уеб приложение през командния ред, препоръчваме първо да създадете поддомейн, на който желаете уеб приложението да работи, както и да създадете директория за файловете на приложението. Можете да направите това чрез разделите "Поддомейни" и "Файлове" на Контролния панел. За да видите списък с наличните настройки за командата, можете да я стартирате без никакви аргументи: sureapp project create За да създадете уеб приложение чрез инструмента за команден ред "sureapp", задължително трябва да зададете име на уеб приложението и поне следните настройки: --engine - позволява да посочите платформата на приложението. Стойността му може да бъде "node" или "custom" (по избор/друга). --engine-version - позволява да посочите версията на платформата на приложението. Ако опцията "--engine" е настроена на "custom", тази опция трябва да се настрои на "-" (тире). А ако опцията "--engine" е настроена на "node", тази опция може да се настрои на "current", "lts" или друга от наличните Node.js версии. За да видите списък с всички налични платформи и версии, използвайте командата "sureapp meta engines". --release-dir - позволява да посочите директорията, в която ще се намират файловете на уеб приложението. Тази директория трябва да е поддиректория на "~/private" директорията на акаунта Ви и в тази опция трябва да зададете целия път до нея. --subdomain - позволява да окажете поддомейна, на който ще бъде достъпно уеб приложението. Поддомейнът няма да се създаде автоматично, ако не съществува. Трябва да създадете поддомейна през раздел "Поддомейни" на Контролния Панел. --domain - позволява да окажете домейна, на който ще бъде достъпно уеб приложението. Можете да паркирате домейни към акаунта Ви чрез раздел "Паркирани домейни" на Контролния панел. --url-path - позволява Ви да окажете URL пътя, на който ще бъде достъпно уеб приложението. Трябва да изберете пътя без поддомейна и домейна. В допълнение, можете да използвате и следните опции: --notes STR - позволява добавянето на бележки като текст. --start-cmd STR - позволява настройването на стартова команда. --rlimit-cpu INT - позволява задаване на максимално време за изпълнение на CPU процеси в секунди. --rlimit-nproc INT - позволява задаване на максимален брой процеси (и нишки) за уеб приложение. --rlimit-core INT - позволява задаване на горен лимит за размера на основните дъмп файлове в байтове. --rlimit-data INT - позволява задаване на максималния размер на сегмента от данни за процеса в байтове. --rlimit-as INT - позволява задаване на максималния размер на виртуалната памет на процеса в байтове. --rlimit-fsize INT - позволява задаване на максималния размер на файловете, създавани от процеса в байтове. --rlimit-fileno INT - позволява задаване на максималния брой на отворените файлове от процеса. --rlimit-stack INT - позволява задаване на максималния размер на стека на процеса в байтове. Ако желаете да създадете уеб приложение с име "MyWebApp", което да работи с текущата (current) версия на Node.js на адрес http://www.yourdomain.com/path/to/your/webapp/, чиито файлове да се намират в директорията /home/your_username/private/your_webapp_dir/ directory на акаунта Ви, трябва да използвате командата "sureapp project create", както следва: sureapp project create --engine node --engine-version current --subdomain www --domain yourdomain.com --release-dir /home/your_username/private/your_webapp_dir/ --url-path /path/to/your/webapp/ MyWebApp Моля да имате предвид, че е от значение, дали използвате главни или малки букви за всички опции. Влизане в конзолата на уеб приложение Можете да влезете в конзолата на уеб приложение с командата "sureapp project shell". Ако желаете да влезете в конзолата на създаденото по-горе приложение с име "MyWebApp", тогава използвайте следната команда: sureapp project shell MyWebApp Повечето от командите за управление, налични за употреба с инструмента "sureapp", работят само след като сте влезли в конзолата на уеб приложението. Управление на уеб приложение Промяна на настройките на уеб приложение След като сте влезли в конзолата на уеб приложение, можете да променяте неговите настройки с командата "sureapp project modify". Командата поддържа същите аргументи като командата "sureapp project create", която е описана в раздел "Създаване на уеб приложение" на тази статия. Например, за да промените платформата на уеб приложението на "custom", трябва да влезете в конзолата на уеб приложението и да използвате тази команда: sureapp project modify --engine custom --engine-version - Промяна на състоянието на уеб приложение Можете да активирате, деактивирате, пускате, спирате, сигнализирате и проверявате статуса на уеб приложение чрез командата "sureapp service". Налични са следните подкоманди: status - позволява да се види текущия статус на уеб приложението. manage - позволява да се променя статуса на уеб приложението. signal - позволява да изпращате сигнали на уеб приложението. Командата "sureapp service manage" поддържа следните опции: --enable - позволява Ви да активирате проекта на уеб приложението. --disable - позволява Ви да спрете всички работещи инстанции и да деактивирате проекта на уеб приложението. --start - позволява Ви да пуснете уеб приложението, както можете да направите от раздел "Уеб приложения" на Контролния панел. --stop - позволява Ви да спрете уеб приложението, както можете да направите от раздел "Уеб приложения" на Контролния панел. --once - позволява Ви да пуснете уеб приложението еднократно без рестартиране, ако вече съществува. --pause - позволява паузиране на работата на уеб приложението, докато не се възобнови. --resume - позволява възобновяване на работата на вече паузирано уеб приложение. Командата "sureapp service signal" поддържа следните опции за изпращане на сигнали към дървото с процеси на уеб приложението. --sigalrm, --SIGALRM - изпращане на сигнал "SIGALRM". --sighup, --SIGHUP - изпращане на сигнал "SIGHUP". --sigint, --SIGINT - изпращане на сигнал "SIGINT". --sigkill, --SIGKILL - изпращане на сигнал "SIGKILL". --sigquit, --SIGQUIT - изпращане на сигнал "SIGQUIT". --sigterm, --SIGTERM - изпращане на сигнал "SIGTERM". --sigwinch, --SIGWINCH - изпращане на сигнал "SIGWINCH". --sigusr1, --SIGUSR1 - изпращане на сигнал "SIGUSR1". --sigusr2, --SIGUSR2 - изпращане на сигнал "SIGUSR2". Ако желаете да активирате уеб приложение, можете да влезете в неговата конзола и да изпълните тази команда: sureapp service manage --enable Управление на променливи на средата на уеб приложение След като сте влезли в конзолата на уеб приложение, можете да управлявате променливите за неговата среда чрез командата "sureapp env". Тази команда има няколко подкоманди: set - позволява да настройвате променливи за уеб приложението. unset - позволява да премахвате настроени променливи за уеб приложението. list - показва списък с всички променливи за средата на уеб приложението. Можете да използвате следната команда, след като сте достъпили конзолата на уеб приложение, ако желаете да настроите нова променлива за неговата среда с име "VAR1" и стойност "NEWVALUE": sureapp env set VAR1 NEWVALUE Преглеждане на настройките на уеб приложение Можете да видите настройките на уеб приложение в лесен за обработка от машини формат чрез командата "sureapp meta config". Командата има няколко опции, които определят в какъв формат да получите настройките на уеб приложението: --json - предоставя настройките на уеб приложението в (pretty printed) JSON формат. --perl - предоставя настройките на уеб приложението в Perl Data::Dumper формат. --yaml - предоставя настройките на уеб приложението в YAML формат. За да получите настройките на уеб приложение в YAML формат, влезте в конзолата на уеб приложението и използвайте следната команда: sureapp meta config --yaml Преглеждане на логовете на уеб приложение Инструментът "sureapp" Ви позволява и да преглеждате или следите логовете на уеб приложения в реално време с командата "sureapp log". Тази команда има следните подкоманди: list - показва списък с логовете за проекта. view - показва съдържанието на определен лог файл. follow - позволява да наблюдавате (tail) лог файл в реално време Ако желаете да следите лог файл за уеб приложение в реално време, използвайте следната команда, след като сте влезли в конзолата на уеб приложението: sureapp log follow Изтриване на уеб приложение Уеб приложенията могат да се изтриват през раздел "Уеб приложения" на Контролния панел, но това може да бъде извършено и чрез командата "sureapp project remove" на CLI инструмента "sureapp". За да изтриете уеб приложение, трябва да въведете само неговото име. Например за изтриване на уеб приложение с име "MyWebApp" трябва да използвате тази команда: sureapp project remove MyWebApp Управление на супервайзъра на уеб приложения Супервайзърът на уеб приложения е системен процес, който поддържа уеб приложенията в работещо състояние. Супервайзърът на уеб приложение може да пуска, спира или рестартира уеб приложения, когато това е необходимо. Той също така поддържа процесите, стартирани от уеб приложенията. Можете да го управлявате с командата "sureapp supervisor", която има следните подкоманди: start - позволява да пуснете супервайзър процеса. stop - позволява да спрете супервайзър процеса. restart - позволява да рестартирате супервайзър процеса. status - позволява да проверите статуса на супервайзър процеса. tree - позволява да видите дървото с подпроцеси на супервайзър процеса. Можете да използвате следната команда, за да видите статуса на супервайзър процеса (напр. дали той работи): sureapp supervisor status

В тази статия можете да откриете как да преглеждате логовете за Вашите уеб приложения. За да видите логовете, трябва да отворите конзолата на приложението и да използвате командите показани по-долу. Можете да откриете как да влезете в конзолата на приложението в статията "Sureapp - CLI инструмент за управление на уеб приложения" от нашата документация. Команда Описание sureapp log follow непрестанно показване на данни от текущия лог файл sureapp log list показване на списък с всички логове за приложението sureapp log view [logfile] преглед на лог, като по подразбиране се избира текущия  

В тази статия ще Ви покажем как да създадете "Hello World" уеб приложение с Node.js в няколко лесни стъпки. Важно: Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да се свържете с нашия екип за повече информация и съдействие. 1. Създайте директория за уеб приложението в директорията private на акаунта Ви (напр. "~/private/app_name"). Уеб приложенията могат да бъдат инсталирани само в тази директория на акаунта. Съветваме Ви да създадете отделна директория за приложението, така че неговите файлове да са отделени от файловете на други уеб приложения и проекти. Можете да създадете директорията чрез раздел "Файлове" на хостинг Контролния панел. 2. Създайте нов файл с име "app.js" в директорията на приложението (напр. "~/private/app_name/app.js"). В този файл добавете следния код, като за целта отново можете да използвате раздел "Файлове" на хостинг Контролния панел: // requiring the HTTP interfaces in nodevar http = require('http');// create an http server to handle requests and responsehttp.createServer(function (req, res) {// sending a response header of 200 OKres.writeHead(200, {'Content-Type': 'text/plain'});// print out Hello Worldres.end('Hello World\n');// listen on assigned port}).listen(process.env.PORT); 3. Създайте уеб приложение чрез раздел "Уеб приложения" във Вашия Контролен панел, използвайки следните данни: "Платформа" - изберете "Node.js" и "Current" за версия. По този начин Вашата Node.js версия за уеб приложението ще се обновява автоматично, когато обновим версията на сървъра. "Име" - въведете желаното от Вас име за уеб приложението (напр. "app_name"). "Домейн", "Поддомейн" и "Уеб път за достъп" - изберете адреса, на който желаете уеб приложението да бъде достъпно (напр. "example.com" за домейн, "www" за поддомейн и "/app_name" за уеб път за достъп ще направи уеб приложението достъпно на "www.example.com/app_name"). Важно е да се спомене, че уеб пътят за достъп не е необходимо да съществува на акаунта, защото той се генерира автоматично от платформата за уеб приложения. "Порт" - портът на уеб приложението се дава служебно и не подлежи на избор. След създаване на уеб приложението, можете да видите назначения порт от платформата в списъка с уеб приложения. "Директория на приложението" - директорията, в която се намират файловете на уеб приложението. Тук трябва да попълните името на директорията, която сте създали в първата стъпка (напр. "/private/app_name"). Натиснете бутона "Създай", за да създадете приложението.4. За да активирате уеб приложението, натиснете бутона с червен кръг до него в списъка с приложения в "Уеб приложения" във Вашия Контролен панел. Изчакайте няколко секунди, докато уеб приложението се активира - статусът му трябва да се промени на "Стартиран", а състоянието му на "OK". Можете да използвате бутона "Презареди" за проверка. 5. Отворете създадената от Вас "Hello World" страница на Node.js, като кликнете на адреса на уеб приложението в колоната "Адрес" от списъка с приложения.

Ние редовно актуализираме Node.js версиите на WebApps сървърите. Тъй като някои приложения може да не са съвместими с последните версии на Node.js, имате опция да използвате Node.js версии по избор чрез инструмента Node Version Manager (nvm). Предпоставки Преди да инсталирате Node Version Manager на Вашия акаунт, трябва да проверите и настроите акаунта си за следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Инсталиране Свържете се към Вашия акаунт чрез SSH и следвайте тези стъпки, за да инсталирате Node Version Manager: Важно: Ако искате да инсталирате Node Version Manager за съществуващ WebApps проект, пропуснете първите две стъпки. Създайте директория, в която желаете да инсталирате Node Version Manager (напр. ~/private/nodejscustom) и влезте в нея, използвайки тази команда:mkdir /home/$USER/private/nodejscustom && cd /home/$USER/private/nodejscustom Създайте уеб приложението, в което да използвате Node.js версия по избор. Можете да създадете проект за уеб приложението чрез раздел "Уеб приложения" на хостинг Контролния панел или използвайки следната команда на sureapp CLI инструмента:sureapp project create \    --engine node \    --engine-version current \    --release-dir "/home/$USER/private/nodejscustom" \    nodejscustom Влезте в проекта на уеб приложението (напр. nodejscustom) чрез тази sureapp CLI команда:sureapp project shell nodejscustom Изтеглете и инсталирайте последната версия на Node Version Manager чрез изпълнение на следната команда:wget https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh && chmod 755 install.sh && ./install.sh && rm install.sh За да заредите Node Version Manager за Вашата SSH сесия, трябва да използвате тази команда:export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" && unset "NPM_CONFIG_PREFIX" След като сте инсталирали Node Version Manager (nvm), можете да инсталирате Node.js версии по избор с командата "nvm install". Например можете да използвате следната команда, за да инсталирате Node.js версия 18.15.0:nvm install 18.15.0 За да промените версията на Node.js (напр. на версия 18.15.0) за Вашата SSH сесия, трябва да използвате следната "nvm use" команда:nvm use 18.15.0Следното съобщение трябва да се покаже в конзолата след изпълнение на командата:Now using node v18.15.0 (npm v9.5.0) Вече можете да работите с Вашето уеб приложение, използвайки желаната от Вас Node.js версия. Настройване на определена Node.js по подразбиране за проект След като сте инсталирали Node Version Manager и желаната Node.js версия (напр. 18.15.0) за Вашия проект, трябва да настроите Node.js версията да се използва по подразбиране. Можете да направите това в няколко стъпки: Създайте стартов скрипт (напр. ~/private/nodejscustom/start.sh) със следното съдържание:#!/bin/bashkillall nodeexport NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"unset NPM_CONFIG_PREFIXnvm use 18.15.0Важно: WebApps супервайзърът няма да спира процесите на Node.js версии по избор при спиране на WebApps проекта (чрез sureapp CLI инструмента, хостинг Контролния панел или при профилактика). Това е причината командата "killall node" да присъства в началото на "start.sh" скрипта. Тя се грижи да се спрат всички останали Node.js процеси от предишни изпълнения  на "start.sh" скрипта преди да се стартира проекта отново. Добавете всички необходими права за стартовия скрипт чрез тази команда:chmod 755 ~/private/nodejscustom/start.sh Добавете стартовия скрипт към стартовата команда на Вашия проект чрез хостинг Контролния панел > раздел "Уеб приложения". Ако стартовата команда на проекта Ви изглежда така::node app.jsТогава трябва да я промените да стартира Node.js версията по избор и след това да изпълнява нормалната стартова команда, както следва:/home/YOUR_USERNAME/private/nodejscustom/start.sh && node app.jsВажно: Не забравяйте да заместите "YOUR_USERNAME" в стартовата команда с потребителското име на Вашия хостинг акаунт. Можете и направо да добавите стартовата команда за проекта като нов (последен) ред в стартовия скрипт "start.sh" и така можете да настроите само скрипта като стартова команда за проекта. По този начин стартовият скрипта ще изглежда така, ако искате проекта Ви да изпълнява командата "node app.js" с Node.js версия 18.15.0:#!/bin/bashkillall nodeexport NVM_DIR="$HOME/.nvm"[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"unset NPM_CONFIG_PREFIXnvm use 18.15.0node app.jsи стартовата команда за проекта Ви ще изглежда по този начин:/home/YOUR_USERNAME/private/nodejscustom/start.shВажно: Трябва да използвате потребителското име на Вашия хостинг акаунт вместо "YOUR_USERNAME" в горната команда.

В тази статия можете да намерите инструкции за инсталиране Odoo - система за ефективно бизнес управление (ERP) и управление на клиенти (CRM). Можете да видите какви промени трябва да направите на акаунта си, как да инсталирате Odoo автоматично, как да инсталирате Odoo ръчно, как да настроите Odoo винаги да работи чрез HTTPS и как да използвате odoo-bin CLI инструмента за управление на Вашата Odoo инсталация. Бележка: Инструкциите в тази статия са изпробвани с Odoo версия 17.0. Предпоставки Преди да инсталирате Odoo има няколко настройки, които трябва да проверите и промените на Вашия акаунт. Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Бърза (автоматична) инсталация За да инсталирате и настроите Odoo, можете да качите този Odoo инсталационен скрипт на Вашия акаунт, да му настроите права 755 и да го изпълните чрез SSH. Можете лесно да направите това, като се свържете се към Вашия акаунт чрез SSH и изпълните следната команда: wget https://tickets.suresupport.com/faq_img/4869.sh -q -P /home/$USER/private && chmod 755 /home/$USER/private/4869.sh && /home/$USER/private/4869.sh && rm /home/$USER/private/4869.sh Резултатът от Odoo инсталационния скрипт трябва да изглежда така: Скриптът ще извърши следните действия: Настройка на PostgreSQL, както е описано в статията ни "Използване на PostgreSQL", ако вече няма наличен PostgreSQL сървър. Създаване на нова PostgreSQL база и потребител за Odoo. Изтегляне на последната версия на Odoo от GIT в директорията "~/private/odoo1". Инсталиране на последната Python версия и настройка да се използва за директорията "~/private/odoo1". Инсталиране на всички нужни скриптове за използване на Python виртуална среда в директорията "~/private/odoo1". Създаване на уеб приложение с име "odoo1". Инсталиране на Odoo. Настройка на уеб приложението, така че Odoo да използва хост името по подразбиране на акаунта. Стартиране на уеб приложението. Показване на URL и данни за вход в Odoo. Важно: За да използвате Odoo с домейн/поддомейн на Вашия акаунт, трябва да промените "odoo1" уеб приложението и да зададете "Домейн", "Поддомейн" и "Уеб път за достъп" чрез раздел "Уеб приложения" на хостинг Контролния панел. Ръчна инсталация За да инсталирате Odoo ръчно, трябва да се свържете към Вашия акаунт чрез SSH и да следвате инструкциите, показани по-долу. Инсталиране на PostgreSQL Odoo използва PostgreSQL бази данни за съхранение на данни, така че трябва да имате PostgreSQL инсталиран на Вашия акаунт. Ако PostgreSQL е вече инсталиран и работещ на Вашия акаунт, можете да пропуснете тази стъпка. В противен случай, можете да инсталирате PostgreSQL като отделно уеб приложение със следната SSH команда: wget https://tickets.suresupport.com/faq_img/4166.sh -q -P /home/$USER/private && chmod 755 /home/$USER/private/4166.sh && /home/$USER/private/4166.sh postgres1 && rm /home/$USER/private/4166.sh && . "/home/$USER/.bashrc" Повече детайли за процеса по инсталиране на PostgreSQL на Вашия акаунт можете да откриете в статията ни "Използване на PostgreSQL". Създаване на PostgreSQL база данни и потребител След като PostgreSQL е настроен и работи на Вашия акаунт, трябва да създадете нова база данни и потребител за Odoo. Можете да създадете автоматично генерирани потребител, парола и база данни с тези команди: odoodbuser="$(pwgen -A 24 1)" && createuser -DRS $odoodbuser && echo -e "DB user: "$odoodbuserodoodbpass="$(pwgen 24 1)" && psql postgres -c "alter user "$odoodbuser" with password '"$odoodbpass"';" && echo -e "DB pass: "$odoodbpassodoodbname="$(pwgen -A 24 1)" && createdb -O $odoodbuser $odoodbname && echo -e "DB name: "$odoodbname Ако искате да създадете PostgreSQL потребител, парола и база данни по Ваш избор, използвайте тези команди: read -p 'Enter PostgreSQL user for Odoo: ' odoodbuser && createuser -e -DRS $odoodbuserread -s -p 'Enter password for user '$odoodbuser': ' odoodbpass && echo && psql postgres -c "alter user "$odoodbuser" with password '"$odoodbpass"';"read -p 'Enter PostgreSQL database name for Odoo: ' odoodbname && createdb -O $odoodbuser $odoodbname   Изтегляне на Odoo Трябва да свалите файловете на Odoo на Вашия акаунт. Най-лесният начин да направите това е да изтеглите файловете директно от Git страницата на Odoo в директорията, където ще инсталирате Odoo (напр. "~/private/odoo1"). Ако директорията не съществува, трябва първо да я създадете с тази команда: mkdir /home/$USER/private/odoo1 Можете да копирате файловете за последната версия на Odoo в директорията на Вашия акаунт (напр. "~/private/odoo1") чрез изпълнението на тази команда: git clone --depth 1 https://github.com/odoo/odoo.git /home/$USER/private/odoo1   Инсталиране на последната Python версия Последната версия на Odoo изисква Python версия 3.11+, а Python версията налична на нашите сървъри по подразбиране е 3.9. Можете да използвате инструмента за управление на Python версии "pyenv", за да инсталирате последната налична версия на Python. Инсталирайте "pyenv" със следните команди: grep -q '^export PYENV_ROOT=.*/private/.pyenv"' "/home/$USER/.bashrc" || echo 'export PYENV_ROOT="/home/$USER/private/.pyenv"' | tee -a /home/$USER/.bashrc >> /home/$USER/.profile && export PYENV_ROOT="/home/$USER/private/.pyenv"grep -q '^command -v pyenv >/dev/null' "/home/$USER/.bashrc" || echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' | tee -a /home/$USER/.bashrc >> /home/$USER/.profile && command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"grep -q '^eval "$(pyenv init -)"' "/home/$USER/.bashrc" || echo 'eval "$(pyenv init -)"' | tee -a /home/$USER/.bashrc >> /home/$USER/.profilecurl -s https://pyenv.run | bash След като "pyenv" е инсталиран, инсталирайте последната версия на Python 3: pyenv install 3Задайте тази версия като локална за Вашата Odoo директория:echo '3' > /home/$USER/private/odoo1/.python-version Приложете новите настройки за Вашата SSH сесия:. "/home/$USER/.bashrc". "/home/$USER/.profile" Настройка на Python виртуална среда Odoo работи чрез Python, за който е добре да се създава изолирана среда за всяко отделно приложение. По този начин всички нужни Python скриптове за приложението Ви ще се използват само за конкретния проект. Можете да създадете такава виртуална среда за Python чрез virtualenv в директория "venv" на Odoo директорията Ви (напр. "~/private/odoo1/venv"), използвайки тези команди: mkdir -p "/home/$USER/.local/bin"grep -q '^PATH=.*/.local/bin' "/home/$USER/.bashrc" || printf '\nPATH="/home/%s/.local/bin:$PATH"\nexport PATH\n' "$USER" >> "/home/$USER/.bashrc"PATH="/home/$USER/.local/bin:$PATH"export PATHcd /home/$USER/private/odoo1/pip3 install virtualenvvirtualenv -p python "/home/$USER/private/odoo1/venv". "/home/$USER/private/odoo1/venv/bin/activate" Последната команда активира виртуалната среда. Инсталиране на всички необходими Python скриптове След като сте активирали виртуалната среда за Python, можете да продължите като обновите Python и инсталирате всички необходими скриптове за Odoo: pip3 install -U pippip3 install -r /home/$USER/private/odoo1/requirements.txt Изпълнението на командите може да отнеме много време. Създаване на уеб приложение Използвайте sureapp CLI инструмента, за да създадете проект с име "odoo1": sureapp project create --engine custom --engine-version - --release-dir /home/$USER/private/odoo1 --start-cmd '. "/home/'$USER'/private/odoo1/venv/bin/activate" && python /home/'$USER'/private/odoo1/odoo-bin --config /home/'$USER'/private/odoo1/odoo.conf' odoo1   Настройте Odoo Трябва да вземете порта на уеб приложението, тъй като той трябва да се използва при инсталирането на Odoo. Можете да направите това със следната команда; while [ -z "$odooappport" ]; do sleep 5; odooappport="$(sureapp project list | grep -E "odoo1.*/home/$USER/private/odoo1" | awk '{print $NF}')"; ((odoocounter++)) && ((odoocounter==12)) && echo 'Could not retrieve port...' && break; done; echo $odooappport Можете да вземете порта и ръчно от колоната "Порт" за Вашето уеб приложение "odoo1" от хостинг Контролния панел > раздел "Уеб приложения". Ако използвате този метод, трябва да замените стринга "$odooappport" с номера на порта в командата за инсталиране.. Изпълнете тази команда, за да инсталирате и настроите Odoo на Вашия акаунт: python /home/$USER/private/odoo1/odoo-bin --db_host /home/$USER/private/postgres1/run --db_user $odoodbuser --database $odoodbname --db_password $odoodbpass --http-port $odooappport -i base --stop-after-init --save --config /home/$USER/private/odoo1/odoo.conf Моля да позволите повече време за завършване на командата, тъй като процеса на инициализиране на Odoo базата данни е продължителен. Настройка на URL за Odoo Изберете страницата, на която да е достъпно Odoo приложението чрез раздел "Уеб приложения" на хостинг Контролния панел. Можете да направите това, като кликнете на бутона с иконка на молив () до проекта "odoo1" и изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран. Стартиране на уеб приложението Стартирайте "odoo1" проекта чрез бутона с иконка на червен кръг () до него в раздел "Уеб приложения" на хостинг Контролния панел. Презаредете страницата, докато състоянието не се промени на "OK" и статуса на "Стартиран". Достъп до Odoo За да достъпите Odoo, посетете избрания в предишната стъпка адрес. Той ще бъде показан в колоната "Адрес" за уеб приложението и трябва да Ви отведе до страницата за вход на Odoo (напр. "http://www.example.com/web/login"): Можете да влезете с потребителското име и парола по подразбиране за Odoo - "admin". Използване на HTTPS Odoo обменя данни за автентикация в чист текст, така че използването на HTTPS криптирана връзка е препоръчително. За да направите това, трябва да инсталирате SSL сертификат на сървъра за Вашия домейн или поддомейн. След като е инсталиран SSL, използвайте бутона "Включи" за Вашия домейн или поддомейн в хостинг Контролния панел > раздел "SSL/HTTPS достъп" > подраздел "Пренасочване към HTTPS". Управление на Odoo чрез odoo-bin Ако искате да използвате команди чрез "odoo-bin" (Odoo CLI инструмента), препоръчваме да създадете следния скрипт: cat <<MANAGE_SH > "/home/$USER/private/odoo1/venv.sh"#!/bin/sh. "/home/$USER/private/odoo1/venv/bin/activate"exec python "/home/$USER/private/odoo1/odoo-bin" "\$*"MANAGE_SHchmod 0700 "/home/$USER/private/odoo1/venv.sh"ln -s "/home/$USER/private/odoo1/venv.sh" "/home/$USER/.local/bin/manage-odoo" Този скрипт ще Ви позволи да изполвате командата "manage-odoo", която ще изпълнява odoo-bin CLI инструмента директно във виртуалната Python среда, която сте настроили за Odoo.

  В тази статия ще откриете как да инсталирате платформата за управление на съдържание и блогове Ghost. Подготовка Преди да инсталирате Ghost на Вашия акаунт, трябва да проверите и настроите акаунта си за следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Създайте нова MySQL 8 база данни за Ghost и MySQL 8 потребител, който да има права за управление на тази база данни, през раздел "MySQL бази данни". Трябва да имате активиран/инсталиран SSL сертификат и да сте активирали пренасочване към HTTPS за домейна/поддомейна, където желаете да използвате Ghost. Можете да инсталирате или активирате сертификат през раздел "SSL/HTTPS достъп" на хостинг Контролния панел. Инсталиране Можете да инсталирате Ghost, като се свържете към Вашия акаунт чрез SSH и следвате тези стъпки: Създайте директорията, в която желаете да инсталирате файловете на Ghost (напр. "~/private/ghost") и влезте в тази директория, като използвате следните команди:mkdir /home/$USER/private/ghostcd /home/$USER/private/ghost Създайте WebApps проект с име "ghost" за Ghost приложението, работещ от новосъздадената папка, чрез следната sureapp CLI команда:sureapp project create \    --engine "node" \    --engine-version "lts" \    --release-dir "/home/$USER/private/ghost/" \    --start-cmd "node current/index.js" \    ghost Влезте в WebApps проекта "ghost", използвайки тази sureapp CLI команда:sureapp project shell ghost Инсталирайте приложението за управление на Ghost през командния ред със следната команда:npm install ghost-cli@latest -g Инсталирайте Ghost чрез тази команда, като не забравяте да заместите стойностите с удебелен шрифт, както следва:ghost install --url https://GHOST_URL --port $PORT --db mysql --dbhost localhost --dbport 3308 --dbname DATABASE_NAME --dbuser DATABASE_USER --dbpass DATABASE_PASSWORD --dir /home/$USER/private/ghost --no-setup-nginx --no-setup-linux-user --no-stack --no-start --process local --mail Sendmail --check-empty false• GHOST_URL с адреса, на който желаете да използвате Ghost приложението.• DATABASE_NAME, DATABASE_USER и DATABASE_PASSWORD с името на MySQL 8 базата данни, MySQL 8 потребителя и неговата парола, които сте създали по-рано.Ако желаете да използвате Ghost приложението на поддомейна ghost.example.com с база данни с име "example_ghostdatabase", MySQL потребителско име "ghostusername" и парола "ghostpassword", тогава трябва да използвате следната команда:ghost install --url https://ghost.example.com --port $PORT --db mysql --dbhost localhost --dbport 3308 --dbname example_ghostdatabase --dbuser ghostusername --dbpass ghostpassword --dir /home/$USER/private/ghost --no-setup-nginx --no-setup-linux-user --no-stack --no-start --process local --mail Sendmail --check-empty false Добавете променлива за WebApps проекта, която го настройва като продуктов сайт:sureapp env set NODE_ENV production Ако желаете да настроите Ghost да изпраща писма чрез Sendmail на сървъра, изпълнете следната команда:sed -i "s~^    \"transport\": \"Direct\"~    \"transport\": \"Sendmail\",\n    \"options\": \{,\n        \"path\": \"/usr/lib/sendmail\"\n    \}~g" /home/$USER/private/ghost/config.production.jsonТя ще промени следния блок с код във файла с настройки на Ghost (config.production.json) от:  "mail": {    "transport": "Direct"  },на:  "mail": {    "transport": "Sendmail",    "options": {        "path": "/usr/lib/sendmail"    }  }, Настроите WebApps проекта да използва адреса, на който желаете да използвате Ghost приложението в раздел "Уеб приложения" на хостинг Контролния панел. Той трябва да съвпада с адреса, който сте задали като GHOST_URL в стъпка №5. Можете да направите това, като кликнете на бутона с иконка на молив () до проекта "ghost" и изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран. Стартирайте приложението чрез бутона с иконка на червен кръг () до него.Бележка: Ако използвате MySQL 5 база данни, първото стартиране на Ghost приложението след неговата инсталация може да отнеме няколко минути. При добавяне на първоначалните настройки за Ghost в MySQL 5 бази данни се връщат грешки от MySQL 5 сървъра като "Field length of ... is too long!", с което добавянето на настройки в базата данни временно се преустановява. Всички добавени данни до момента остават, включително и генериралите грешката такива. Приложението ще стартира успешно, след като всички първоначални настройки се добавят успешно в MySQL 5 базата данни. Посетете адреса на Ghost приложението (напр. https://ghost.example.com/).

В тази статия можете да откриете как да инсталирате и настроите Ruby on Rails проект чрез Ruby Version Manager (RVM) с WebApps платформата. Предпоставки Преди да инсталирате Ruby on Rails на Вашия акаунт, трябва да проверите и настроите акаунта си за следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Инсталиране на Ruby Version Manager Повечето от инсталационните стъпки са взети от официалните инструкции за инсталиране на RVM. За да инсталирате Ruby Version Manager, свържете се към Вашия акаунт чрез SSH и следвайте тези стъпки: RVM пакетите са подписани с GnuPG, така че трябва да настроите GnuPG и да изтеглите необходимите публични ключове. За целта създайте директория, където да съхраните ключовете, презаредете Вашия bash профил и изтеглете и импортирайте ключовете с тези команди:echo "export GNUPGHOME=$HOME/private/.gnupg" >> ~/.bashrcsource ~/.bashrccurl -sSL https://rvm.io/mpapis.asc | gpg --import - && curl -sSL https://rvm.io/pkuczynski.asc | gpg --import - && gpgconf --kill gpg-agent За да изтеглите и стартирате инсталационния RVM скрипт, изпълнете тази команда:curl -sSL https://get.rvm.io | grep -v 'partition=`df' | bash -s -- --path /home/$USER/private/.rvm --ignore-dotfiles Трябва да изпълните следната команда във всички отворени SSH екрани, за да започнете да използвате RVM:source /home/$USER/private/.rvm/scripts/rvm Добавете RVM към bash конфигурационния файл:echo "source /home/$USER/private/.rvm/scripts/rvm" >> ~/.bashrc Затворете всички SSH екрани и се свържете отново. Можете да проверите дали RVM е зареден успешно за Вашата SSH сесия чрез следната команда:type rvm | head -n 1Трябва да получите "rvm is a function" като отговор в конзолата. RVM използва /bin/df инструмента, за да провери наличното свободно дисково пространство на сървъра, преди инсталирането на нова Ruby версия. Достъпът до този инструмент е забранен на нашите сървъри, с което инсталирането на нова Ruby версия ще бъде неуспешно. Тъй като няма опция да се спре тази проверка, трябва ръчно да се промени функцията __rvm_calculate_space_free. Можете да направите това със следната команда, която ще информира RVM, че има 9999MB свободното дисково пространство:sed -i "/__rvm_calculate_space_free/c\__free_space=9999M" /home/$USER/private/.rvm/scripts/functions/manage/base_install /home/$USER/private/.rvm/scripts/migrateВажно: Ако обновите RVM до по-нова версия, може да се наложи да направите тази промяна отново. "Autolibs" е RVM инструмент, който автоматично инсталира всички необходими системни пакети. Тъй като Вашия SSH потребител няма достъп за такива действия, трябва да изключите този инструмент със следната команда: rvm autolibs 0Ако някои от gem инсталациите са неуспешни или Вашият проект не работи заради липсващи задължителни пакети, можете да се свържете с нас за помощ. Със следната команда можете да проверите за липсващи задължителни пакети:rvm requirements Инсталиране на Ruby При компилиране на Rubby, RVM може да достигне ограничение за памет, затова ограничете RVM да използва не повече от 3 процеса едновременно чрез следната команда:echo "rvm_make_flags=( -j 3 )" >> /home/$USER/private/.rvm/scripts/functions/rvmrcЗа да се приложи тази промяна, презаредете RVM:rvm reload Инсталирайте последната налична версия за Ruby с тази команда:rvm install ruby --latestRVM ще компилира Ruby изцяло и ще инсталира глобален gemset. В момента на писане на тази статия, последната налична версия на Ruby е 3.3.2. За да преминете към използването на тази версия, изпълнете следната команда:rvm use 3.3.2 Създаване на WebApps проект за Ruby on Rails Създайте директория за Rails WebApps проекта (напр. "~/private/blog") и влезте в нея, използвайки тази команда:mkdir /home/$USER/private/blog && cd /home/$USER/private/blog Създайте WebApps проекта за Ruby on Rails приложението. Можете да създадете проект за уеб приложението чрез раздел "Уеб приложения" на хостинг Контролния панел или използвайки следната команда на sureapp CLI инструмента:sureapp project create \    --engine custom \    --engine-version - \    --release-dir "/home/$USER/private/blog" \    BlogИмето на WebApps проекта в дадения пример е "Blog". Инсталиране и настройка на Rails Можете да инсталирате Rails директно в глобалния gemset, но много разработчици предпочитат да пазят глобалния gemset чист и затова инсталират Rails в gemset на всеки отделен проект. Така отделните проекти могат да имат различни версии на Rails. За да инсталирате Rails, следвайте тези стъпки: От създаването на проекта в предишната стъпка трябва да се намирате в неговата директория (напр. "~/private/blog"), така че можете да създадете gemset за Вашия блог проект, който ще е с еднакво име с директорията - "blog":rvm use ruby-3.3.2@blog --ruby-version --createОпцията “—ruby-version” създава файлове ".ruby-version" и ".ruby-gemset" в главната директория на проекта. RVM разпознава тези файлове в главната директория на приложението и с тях зарежда зададената версия на Ruby и правилния gemset, когато влезете в тази директория. За да инсталирате Rails в gemset "blog", използвайте тази команда:gem install railsПроцесът може да отнеме повече време, тъй като Rails изисква добавянето на много допълнителни gem пакети. Създайте нов Rails проект, който ще използва името на текущата директория ("blog"):rails new .Може да се покаже съобщение дали желаете да презапишете файла ".ruby-version". Старият и новият файл са с идентично съдържание, така че няма значение коя опция ще изберете. Ако някои gem пакети не са инсталирани успешно локално, можете да коригирате това със следната команда:bundle install Rails работи по подразбиране на порт 3000. Трябва да промените порта с този на Вашия WebApps проект във файла "config/puma.rb". Можете да направите това ръчно чрез раздел "Файлове" на хостинг Контролния панел, като промените порта в следния ред на файла:port ENV.fetch("PORT") { 3000 }Можете да направите това и чрез следните команди, които ще вземат порта на Вашия WebApps проект (работещ в директория "~/private/blog/") и ще го сложат на правилното място във въпросния файл:RAILS_PORT=$(sureapp project list | grep -E "/home/$USER/private/blog"| awk '{print $NF}')sed -i "s~^port ENV.fetch(\"PORT\") { 3000 }~port ENV.fetch\(\"PORT\"\) { $RAILS_PORT }~g" /home/$USER/private/blog/config/puma.rb Добавете домейна/поддомейна, къдете ще използвате Rails, във файла "config/application.rb" в блока с код "class Application < Rails::Application", за да позволите заявки от Вашия домейн/поддомейн към Ruby on Rails приложението. Ако желаете сайтът Ви да работи с поддомейн blog.example.com, тогава добавете следния ред във файла "config/application.rb":config.hosts << "blog.example.com"Можете да използвате и следната команда, за да постигнете това:sed -i 's~^    # config\.eager_load_paths << Rails\.root\.join("extras")~    # config.eager_load_paths << Rails.root.join("extras")\n    config.hosts << "blog.example.com"~g' /home/$USER/private/blog/config/application.rb Настройка и активиране на WebApps проекта Трябва да настроите WebApps проекта (напр. "Blog") да стартира Rails уеб сървър за Вашето приложение в RVM средата. Можете да направите това със следната команда:sureapp project modify --start "source $(rvm env --path) && rails server" BlogКомандата за стартиране на проекта ще зарежда съответната RVM среда, която се взима с командата "rvm env --path", след което се стартира и Rails уеб сървъра с командата "rails server". Изберете страницата, на която да е достъпно Rails приложението чрез раздел "Уеб приложения" на хостинг Контролния панел. Можете да направите това, като кликнете на бутона с иконка на молив () до проекта "Blog" и изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран. Стартирайте "Blog" проекта чрез бутона с иконка на червен кръг () до него в раздел "Уеб приложения" на хостинг Контролния панел. Посетете адреса на Rails приложението (напр. https://blog.example.com/).

Тази статия съдържа инструкции за използване на наличния MongoDB сървър за бази данни на нашите сървъри, както и за инсталиране на собствен MongoDB сървър чрез нашата платформата за уеб приложения (WebApps). Важно: Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Свържете към Вашия акаунт чрез SSH и следвайте стъпките за избрания от Вас метод за използване/инсталиране на MongoDB. Използване на наличния по подразбиране MongoDB сървър Можете да използвате "mongod" пакета на нашите сървъри, за да използвате MongoDB. По подразбиране MongoDB използва порт "27017" и съхранява данните си в директорията "/data/db". Тъй като тези порт и директория не са достъпни за хостинг акаунтите, при използване на "mongod" пакета трябва да се използват отделни порт ("port") и директория за съхранение на данните ("dbpath"). За целта трябва да създадете директория, където да съхранявате MongoDB данните (напр. в директорията ~/private/mongodb/data/db):mkdir -pv /home/$USER/private/mongodb/data/dbСлед това създайте WebApps проект със следната sureapp CLI команда:sureapp project create \    --engine "custom" \    --engine-version "-" \    --release-dir "/home/$USER/private/mongodb/" \    --start-cmd "mongod --dbpath /home/$USER/private/mongodb/data/db --port \$PORT" \    mongodb Инсталиране на собствен MongoDB сървър Ако искате Вашият проект да използва версия на MongoDB, която е различна от инсталираната по подразбиране на сървъра, тогава можете да следвате тези стъпки: Отидете в директорията, в която желаете да инсталирате MongoDB (напр. "~/.local/bin)cd /home/$USER/.local/bin Изтеглете файловете за желаната версия на MongoDB от официалната страница. Трябва да изберете версията на MongoDB (напр. 7.0.12) , "Debian 11.0 x64" за платформа, "tgz" за пакет и да кликнете на бутона за копиране на линка (напр. "https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-debian11-7.0.12.tgz"). Можете да изтеглите файла на сървъра със следната "curl" команда:curl -O https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-debian11-7.0.12.tgz Разархивирайте изтегления файл с командата "tar":tar -zxvf mongodb-linux-x86_64-debian11-7.0.12.tgz Копирайте mongosh файловете в директорията на MongoDB (напр. "~/.local/bin).cp -R -n mongodb-linux-x86_64-debian11-7.0.12/bin/* /home/$USER/.local/bin Уверете се, че пътят до MongoDB файловете е добавен в променливата "PATH". Можете да направите това, като добавите следния ред с код в ".bashrc" файла на Вашия акаунт (~/.bashrc):export PATH=$HOME/.local/bin:$PATHАко MongoDB файловете се намират в друга директория, то я добавете в променливата "PATH":export PATH=<mongodb-install-directory>/bin:$PATH Създайте директорията на уеб приложението, където ще използвате MongoDB (напр. "~/private/mongodb"). В тази директория, трябва да създадете директория data/db (напр. "~/private/mongodb/data/db"):mkdir -pv /home/$USER/private/mongodb/data/db Създайте WebApps проект със следната sureapp CLI команда:sureapp project create \    --engine "custom" \    --engine-version "-" \    --release-dir "/home/$USER/private/mongodb/" \    --start-cmd "/home/$USER/.local/bin/mongod --dbpath /home/$USER/private/mongodb/data/db --port \$PORT" \    mongodbВажно: Заместете "/home/$USER/.local/bin/mongod" с пълния път до Вашия собствен MongoDB сървър. Настройване на WebApps проект Отворете раздел "Уеб приложения" във Вашия хостинг Контролен панел и кликнете на бутона с иконка на молив () до проекта "mongodb". Изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран.Стартирайте приложението чрез бутона с иконка на червен кръг () до него. Посетете линка от колоната "Адрес" за проекта, където трябва да видите следното съобщение: It looks like you are trying to access MongoDB over HTTP on the native driver port. Ограничаване на достъпа Можете да включите автентикация за MongoDB, с което да ограничите достъпа до базите Ви данни. Ако сте активирали ограничението на достъпа за MongoDB, потребителите ще могат да изпълняват само действията, които са разрешени за техните роли. Можете да следвате тези стъпки, за да добавите администраторски потребител за MongoDB без ограничение на достъпа и след това да ограничите достъпа: Свържете се с MongoDB чрез mongosh:mongosh --port $PORTБележка: Инструмента "mongosh" за управление на MongoDB през командния ред е заместистел на "mongo" инструмента, който е спрян от поддръжка от MongoDB v5.0. Създайте нов потребител с администраторски права:use admindb.createUser({user: "myUserAdmin",pwd: "abc123",roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]}) Важно: Заменете myUserAdmin и abc123 с потребителското име и паролата, които желаете да използвате. Излезте от mongosh. Променете стартовата команда за MongoDB приложението Ви, така че да съдържа опцията "--auth" за активиране на контрол на достъпа. Ако използвате наличния по подразбиране MongoDB сървър, можете да промените стартовата команда така:sureapp project modify\    --start-cmd "mongod --auth --dbpath /home/$USER/private/mongodb/data/db --port \$PORT" \    mongodbили така, ако използвате собствена инсталация на MongoDB сървър:sureapp project modify\    --start-cmd "/home/$USER/.local/bin/mongod --auth --dbpath /home/$USER/private/mongodb/data/db --port \$PORT" \    mongodb Рестартирайте MongoDB приложението с тази команда:sureapp service manage --disable mongodb && sureapp service manage --enable mongodb Свързване с MongoDB база данни Стандартния формат за URI връзка с MongoDB база данни изглежда така:mongodb://[username:password@]host1[:port1][,...hostN[:portN]]][/[database][?options]] Следователно за връзка с базата данни, дадена за пример в тази статия, можете да използвате следния низ:mongodb://myUserAdmin:abc123@localhost:16250/admin

В тази статия ще Ви покажем как да настроите PostgreSQL сървър за бази данни чрез платформата за Уеб приложения (WebApps). Важно: Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Бърза настройка Ако искате бързо да настроите и стартирате PostgreSQL сървър на Вашия акаунт, изтеглете този скрипт за настройка на PostgreSQL на Вашия акаунт и го изпълнете. Скриптът ще създаде и настрои WebApps проект и PostgreSQL сървър на Вашия акаунт, така че да можете да го използвате веднага. Трябва да добавите права за изпълнение на скрипта след изтеглянето му на Вашия акаунт и след това да го изпълните. Можете да направите това със следните команди: mv 4166.sh setup_postgresql.shchmod 755 setup_postgresql.sh./setup_postgresql.sh postgres1 В този случай можете да пропуснете стъпките за "Настройка на PostgreSQL Server" и "Създаване на WebApps проект" от тази статия, а можете да продължите директно към създаването на бази данни и роли. Настройка на PostgreSQL Server На сървъра има поддръжка за PostgreSQL. Трябва само да настроите PostgreSQL сървъра да използва Вашите бази данни от WebApps платформата. За целта трябва първо да създаде директориите за съхранение на данните Ви на сървъра. Можете да използвате "private/" директорията, която е налична във всеки хостинг акаунт: sureapp_project="postgres1"pg_app_dir="/home/$USER/private/$sureapp_project"mkdir -m 0700 "$pg_app_dir"mkdir -m 0700 "$pg_app_dir/run"mkdir -m 0700 "$pg_app_dir/sureapp"touch "$pg_app_dir/.psql_history"chmod 0600 "$pg_app_dir/.psql_history" Следващата стъпка е да инициализирате сървъра за бази данни и да добавите основен потребител (superuser). По подразбиране потребителското име на основния потребител ще е същото като потребителското име на Вашия хостинг акаунт (напр. "example"): superuser_pass="$(pwgen 24 1)"touch "$pg_app_dir/.superuser-pwfile"chmod 0600 "$pg_app_dir/.superuser-pwfile"echo "$superuser_pass" > "$pg_app_dir/.superuser-pwfile"for pg_install_dir in $(find /usr/lib/postgresql -maxdepth 1 -type d -o -type l 2>/dev/null | sort -Vr)do    [ -x "$pg_install_dir/bin/initdb" ] && breakdone"$pg_install_dir/bin/initdb" -D "$pg_app_dir/pgdata" --auth=md5 --pwfile="$pg_app_dir/.superuser-pwfile" && rm -f "$pg_app_dir/.superuser-pwfile"touch "$pg_app_dir/.pgpass"chmod 0600 "$pg_app_dir/.pgpass"printf "*:*:*:%s:%s\n" "$USER" "$superuser_pass" > "$pg_app_dir/.pgpass" Сега трябва да настроите PostgreSQL сървъра да слуша за заявки чрез UNIX сокет на правилното място във Вашия акаунт: sed -i "s~^#*unix_socket_directories = .*\(\s*#.*\)~unix_socket_directories = '$pg_app_dir/run' \1~g" "$pg_app_dir/pgdata/postgresql.conf"sed -i "s~^#*unix_socket_permissions = .*\(\s*#.*\)~unix_socket_permissions = 0700 \1~g" "$pg_app_dir/pgdata/postgresql.conf"sed -i "s~^#*listen_addresses = .*\(\s*#.*\)~listen_addresses = '' \1~g" "$pg_app_dir/pgdata/postgresql.conf" За да направите стартирането на PostgreSQL услугата по-лесно, можете да използвате следните команди за създаването на стартов скрипт: printf '#!/bin/sh\nexec %s/bin/postgres -D %s/pgdata\n' "$pg_install_dir" "$pg_app_dir" > "$pg_app_dir/start.sh"chmod 0700 "$pg_app_dir/start.sh" За да използвате различни инструменти за управление на PostgreSQL, трябва да направите следните промени във Вашия .bashrc файл: grep -q '^PGHOST=' "/home/$USER/.bashrc" || cat <<BASHRC >> "/home/$USER/.bashrc"# $sureapp_project client configurationPGHOST="$pg_app_dir/run"export PGHOSTPGPASSFILE="$pg_app_dir/.pgpass"export PGPASSFILEPSQL_HISTORY="$pg_app_dir/.psql_history"export PSQL_HISTORYBASHRC. "/home/$USER/.bashrc" Създаване на WebApps проект За да стартирате сървър за бази данни, първо трябва да настроите PostgreSQL услугата. Можете да направите това по два начина: Можете да създадете проект чрез раздел "Уеб приложения" на хостинг Контролния панел за Вашия акаунт. Можете да използвате sureapp CLI инструмента за управление на уеб приложения за създаване на проекта. Използване на раздел "Уеб приложения" на хостинг Контролния панел Ако изберете да създадете приложението чрез хостинг Контролния панел, използвайте следните настройки: Платформа: Custom Име: postgres1 - Името на Вашето приложение. Домейн: example.com - Можете да изберете всеки домейн от списъка. Това няма да окаже никакво влияние на работата на PostgreSQL сървъра. Поддомейн: www - Можете да изберете всеки поддомейн от списъка. Това няма да окаже никакво влияние на PostgreSQL сървъра, защото той няма да работи на TCP порт. Уеб път за достъп: /Efu6dunox0vieyelahch2eaf - Уеб пътят за достъп трябва да бъде измислен път, който не се използва на Вашия сайт. В дадения пример използваме "/Efu6dunox0vieyelahch2eaf", но можете да използвате произволен път. Не оставяйте полето празно или със стойността по подразбиране ('/'), защото сайтът Ви може да спре да работи изцяло. Директория на приложението: /private/postgres1/sureapp - Ако сте променили основната директория за PostgreSQL в скрипта по-горе, въведете зададения от Вас път. Команда за стартиране: /home/example/private/postgres1/start.sh - Тук трябва да заместите "example" с потребителското име на Вашия хостинг акаунт. След като създадете и активирате приложението, ще можете да използвате новия сървър за PostgreSQL бази данни. Използване на sureapp CLI инструмента WebApps проектите могат да се управляват чрез "sureapp" CLI инструмента. За да създадете и стартирате нов PostgreSQL проект, използвайте следните команди: sureapp project create \    --engine "custom" \    --engine-version "-" \    --release-dir "$pg_app_dir/sureapp" \    --start-cmd "$pg_app_dir/start.sh" \    "$sureapp_project"sureapp service manage --enable "$sureapp_project"sureapp service manage --start "$sureapp_project" PostgreSQL сървърът ще е стартиран и наличен за употреба след изпълнение на горните команди. Създаване на бази данни и роли След като сървърът е започнал да работи, трябва да добавите нов потребител и база данни за Вашето приложение със следните SSH команди: . "/home/$USER/.bashrc" # For $PGHOSTcreateuser -e -DEPRS "pgusername" createdb -e -O "pgusername" "pgdatabase" Трябва да заместисте потребителското име и името на базата данни в примера с детайлите, които искате да използвате във Вашето приложение. Резервни копия На нашите сървъри автоматично се създават резервни копия веднъж на всеки 12 часа, така че не бива да се тревожите за загуба на данни. Тези резервни копия ще Ви позволят да възстановите Вашите данни от системно резервно копие, ако нещо се обърка със Вашия сайт. Системите за бази данни като PostgreSQL и MySQL съхраняват данните си на сървъра по специален начин, така че трябва да се използва по-специален подход за създаване на резервни копия, така че те да са консистентни и използваеми. За MySQL бази данни, които са налични по подразбиране за всички хостинг акаунти, създаването на резервни копия е автоматизирано от хостинг Контролния панел. Всички MySQL данни се архивират на определен интервал от нашата система и те могат да се възстановят лесно чрез раздел "Възстановяване" на хостинг Контролния панел. За PostgreSQL бази данни, работещи чрез WebApps платформата за уеб приложения, трябва да създадете отделна процедура за създаване на резервни копия. Следния блок с код ще създаде два скрипта във Вашия WebApps проект (backup.sh и restore.sh), с които ще можете да създавате и да възстановявате данни от резервни копия, a aко сте използвали метода за бърза настройка, тези файлове вече ще са създадени за Вашия проект: mkdir -m 0700 "$pg_app_dir/backup" cat <<BACKUP_SH > "$pg_app_dir/backup.sh" #!/bin/sh set -e die() { printf "%s\n" "\$*" 1>&2 && exit 1; } PGPASSFILE="$pg_app_dir/.pgpass" export PGPASSFILE "$pg_install_dir/bin/pg_dumpall" --clean --host "$pg_app_dir/run" | gzip --stdout -- > "$pg_app_dir/backup/pgdump.sql.gz" || die "PostgreSQL backup failed: $sureapp_project" BACKUP_SH chmod 700 "$pg_app_dir/backup.sh" cat <<RESTORE_SH > "$pg_app_dir/restore.sh" #!/bin/sh set -e die() { printf "%s\n" "\$*" 1>&2 && exit 1; } PGPASSFILE="$pg_app_dir/.pgpass" export PGPASSFILE archive="$pg_app_dir/backup/pgdump.sql.gz" [ -f "\$archive" ] || die "Backup file does not exist: \$archive" zgrep -m1 "Dumped" "\$archive" || die "Backup file does not contain PostgreSQL data: \$archive" gzip --decompress --stdout "\$archive" | "$pg_install_dir/bin/psql" --quiet --host "$pg_app_dir/run" postgres RESTORE_SH chmod 700 "$pg_app_dir/restore.sh" След като са създадени тези скриптове, можете да настроите планирана задача, която изпълнява скрипта "backup.sh" веднъж на 12 часа чрез раздел "Cron Jobs" на хостинг Контролния панел. Тази крон задача ще създава резервно копие с име "pgdump.sql.gz", което ще се презаписва при всяко изпълнение на скрипта. По този начин всяко системно резервно копие ще съдържа най-новото копие на файла. В най-добрия случай няма да Ви се наложи да използвате restore.sh скрипта. Ако все пак Ви се наложи, той ще премахне всички данни от Вашата PostgreSQL база данни и ще възстанови в нея данните от архива с име "pgdump.sql.gz". Ако желаете да възстановите данни от определено резервно копие, можете да възстановите файла "pgdump.sql.gz" от автоматично създаден системен архив и след това да изпълните restore.sh скрипта чрез командата: ./restore.sh PHP настройка Ако ще използвате PHP приложение с PostgreSQL база данни, трябва да промените конфигурационния файл за PHP (php.ini). Може да пропуснете тези стъпки, ако няма да използвате PHP. PHP може да използва две библиотеки за свързване с PostgreSQL бази данни. Те са разширение за PostgreSQL бази данни и по-абстрактния PDO драйвър за PostgreSQL. Трябва да активирате правилното PHP разширение за Вашето софтуерно приложение чрез раздел "PHP настройки" на хостинг Контролния панел, следвайки тези стъпки: Натиснете бутона "Промени" за домейна/поддомейна, където желаете да използвате PostgreSQL база данни. Отбележете с отметка разширението "PostgreSQL" или "PDO_PGSQL" от раздел Разширения. Натиснете бутона Запази. Разширенията могат да се активират и ръчно чрез добавяне на съотвения ред в PHP конфигурационен файл (php.ini): Разширение PostgreSQL: extension = pgsql.so PDO драйвър за PostgreSQL: extension = pdo_pgsql.so Инструкции за промяна на други PHP настройки за Вашия акаунт можете да откриете в статията ни "Промяна на PHP настройките за Вашия акаунт". Активиране на външни връзки По подразбиране PostgreSQL сървърът е настроен да приема само локални връзки. Има начин да активирате външни връзки, ако желаете да се свържете с Вашия PostgreSQL сървър от външен сървър или чрез инструмент за управление на PostgreSQL бази данни като pgAdmin. За да активирате външните връзки, трябва да обновите два конфигурационни файла: pgdata/postgresql.conf pgdata/pg_hba.conf Във файла "pgdata/postgresql.conf" трябва да промените следните редове: listen_addresses = '' # what IP address(es) to listen on; port = 5432                             # (change requires restart) като настроите "listen_address" да бъде "*", а "port" да бъде порта на Вашия WebApps проект. Можете да откриете порта в раздел "Уеб приложения" на Вашия хостинг Контролен панел. В края на файла "pgdata/pg_hba.conf" трябва да добавите следния ред: host all all 0.0.0.0/0 md5 Тези промени ще настроят Вашия PostgreSQL сървър да приема връзки от всички външни локации, ако предоставят правилно потребителско име и парола. Ако желаете да ограничите достъпа само за определен IP адрес (напр. 123.123.123.123), използвайте този ред: host all all 123.123.123.123/32 md5 След завършване на промените, трябва да рестартирате WebApps проекта чрез раздел "Уеб приложения" на хостинг Контролния панел, за да се приложат. Бележка: Променяйки порта в конфигурационния файл на PostgreSQL сървъра, определени функционалности/команди ще спрат да работят (напр. psql, createuser и createdb). За да можете да ги използвате, ще трябва да задавате новия порт в командите:psql -p <WebApp port>

В тази статия можете да намерите инструкции за инсталиране на phpPgAdmin инструмента и настройката му за свързване с Ваши съществуващи PostgreSQL бази данни. Ако нямате инсталиран PostgreSQL сървър на Вашия акаунт, следвайте инструкциите в статията ни за използване на PostgreSQL. Не забравяйте да активирате външните връзки за Вашия PostgreSQL сървър, защото в противен случай няма да можете да се свържете с PostgreSQL сървъра чрез phpPgAdmin. След като сте настроили Вашия PostgreSQL сървър и той работи, трябва да изтеглите phpPgAdmin инструмента. Можете да направите това от неговата GitHub страница. Трябва да качите архива на Вашия акаунт. След това разархивирайте качения архив и променете следните два реда във файла "/conf/config.inc.php" от: $conf['servers'][0]['host'] = '';$conf['servers'][0]['port'] = '5432'; на: $conf['servers'][0]['host'] = 'localhost';$conf['servers'][0]['port'] = 'PostgreSQL WebApp port'; Заместете "PostgreSQL WebApp port" с порта на Вашия PosgreSQL WebApps проект, който можете да видите в раздел "Уеб приложения" на Вашия хостинг Контролен панел. Можете да използвате раздел "Файлове" на хостинг Контролния панел за качването на архива, разархивирането му и промяната на конфигурационния файл. Вече можете да отидете на страницата, на която сте инсталирали phpPgAdmin, и да влезете с Вашите PostgreSQL потребителско име и парола.

  В тази статия ще откриете инструкции за инсталиране и стартиране на Flask чрез WebApps платформата. Flask е платформа за уеб приложения, базирана на Python. Едни от най-популярните сайтове, използващи Flask, са Pinterest и LinkedIn. Подготовка Преди да инсталирате Flask на Вашия акаунт, трябва да проверите и настроите акаунта си за следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Инсталиране За да инсталирате Flask, се свържете към Вашия акаунт чрез SSH и следвайте тези стъпки: Създайте директорията, в която желаете да инсталирате файловете на Flask (напр. "~/private/flask") и влезте в тази директория, като използвате следните команди:mkdir /home/$USER/private/flaskcd /home/$USER/private/flask Създайте "Hello World" Python скрипт, който ще показва текста "Hello World!":cat <<FLASK_HELLO > /home/$USER/private/flask/hello.pyfrom flask import Flaskapp = Flask(__name__)@app.route('/')def hello_world():    return 'Hello World!'FLASK_HELLOchmod +x /home/$USER/private/flask/hello.py Създайте стартов скрипт за WebApp проекта, който да стартира Flask сървъра и да показва текста от горния скрипт:cat <<FLASK_START > /home/$USER/private/flask/start.sh#!/bin/shexport LC_ALL=C.UTF-8export LANG=C.UTF-8source /home/$USER/private/flask/venv/bin/activateexec env FLASK_APP=/home/$USER/private/flask/hello.py flask run --port=$PORTFLASK_STARTchmod +x /home/$USER/private/flask/start.sh Създайте WebApp проект за Flask приложението, използвайки следната команда:sureapp project create \    --engine "custom" \    --engine-version "-" \    --release-dir "/home/$USER/private/flask/" \    --start-cmd "sh /home/$USER/private/flask/start.sh" \    flask Влезте във "flask" WebApps проекта чрез следната sureapp CLI команда:sureapp project shell flask Тъй като Flask работи чрез Python, препоръчваме да настроите изолирана среда, в която да инсталирате Flask пакетите за Python за Вашето приложение. Можете да настроите виртуална среда за Python чрез "virtualenv" в папката "venv" на Flask директорията (напр. ~/private/flask) и да инсталирате Flask, използвайки тези команди:mkdir -p "/home/$USER/.local/bin"grep -q '^PATH=.*/.local/bin' "/home/$USER/.bashrc" || printf '\nPATH="/home/%s/.local/bin:$PATH"\nexport PATH\n' "$USER" >> "/home/$USER/.bashrc"PATH="/home/$USER/.local/bin:$PATH"export PATHpip3 install virtualenvvirtualenv -p python3 "/home/$USER/private/flask/venv". "/home/$USER/private/flask/venv/bin/activate"pip3 install Flask Изберете страницата, на която да е достъпно Flask приложението чрез раздел "Уеб приложения" на хостинг Контролния панел. Можете да направите това, като кликнете на бутона с иконка на молив () до проекта "flask" и изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран. Стартирайте приложението чрез бутона с иконка на червен кръг () до него. Отворете избрания от Вас адрес за Flask приложението (напр. http://flask.example.com) и трябва да видите страница с текста "Hello World!".

В тази статия можете да намерите инструкции за инсталиране и използване на Elasticsearch версия 7 (софтуер за търсене/търсачка) чрез WebApps платформата. Версия 7 се използва от популярни приложения като Magento. За някои хостинг планове, Elasticsearch може да се инсталира директно през раздел "App Installer" на Контролния панел. Ако не го откривате в раздел "App Installer", тогава можете да го инсталирате ръчно, следвайки инструкциите от тази статия. Важно: Elasticsearch използва много ресурси, така че дори и да го инсталирате ръчно, той може да не функционира правилно с някои планове поради недостиг на налични ресурси. Подготовка Преди да инсталирате Elasticsearch на Вашия акаунт, трябва да проверите и настроите акаунта си за следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Инсталиране За да инсталирате Elasticsearch, се свържете към Вашия акаунт чрез SSH и следвайте тези стъпки: Създайте директорията, в която желаете да инсталирате файловете на Elasticsearch (напр. "~/private/elastic") и влезте в тази директория, като използвате следните команди:mkdir /home/$USER/private/elasticcd /home/$USER/private/elastic Изтеглете на Вашия акаунт най-актуалния Linux x86_64 пакет за версия 7 на Elasticsearch от официалната страница. В момента на писане на тази статия, последната версия е 7.17.21. Линкът за изтегляне на тази версия е https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.21-linux-x86_64.tar.gz, така че можете да я изтеглите и разархивирате във Вашата директория за Elasticsearch с тези команди:wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-7.17.21-linux-x86_64.tar.gztar zxf elasticsearch-7.17.21-linux-x86_64.tar.gz --strip-components=1rm elasticsearch-7.17.21-linux-x86_64.tar.gzВажно: Уверете се, че използвате линка за последната версия на Elasticsearch за Linux в горните команди. Създайте файл, който да стартира Elasticsearch приложението, при стартиране на WebApps проекта и му добавете права за изпълнение чрез следните команди:cat <<ELASTIC_START > /home/$USER/private/elastic/start.sh#!/bin/bashcd /home/$USER/private/elasticexport ES_JAVA_OPTS="-Xms128m -Xmx128m"exec ./bin/elasticsearchELASTIC_STARTchmod +x /home/$USER/private/elastic/start.sh Създайте WebApps проект с име "elastic" за Elasticsearch приложението, използвайки следната команда:sureapp project create \    --engine "custom" \    --engine-version "-" \    --release-dir "/home/$USER/private/elastic/" \    --start-cmd "sh /home/$USER/private/elastic/start.sh" \    elastic Създайте втори WebApps проект с име "portholder" със следната команда, който ще запази втори (допълнителен) порт за Elasticsearch приложението, което ще добавим по-късно в неговите настройки:sureapp project create \    --engine "custom" \    --engine-version "-" \    --release-dir "/home/$USER/private/" \    portholder Изберете страницата, на която да е достъпно Elasticsearch приложението чрез раздел "Уеб приложения" на хостинг Контролния панел. Можете да направите това, като кликнете на бутона с иконка на молив () до проекта "elastic" и изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран. Последната стъпка от подготовката на Elasticsearch приложението е да се добавят в настройките му двата порта на създадените WebApps проекти. Можете да направите това с изпълнение на следните команди:ELASTIC_PORT=$(sureapp project list | grep -E "/home/$USER/private/elastic"| awk '{print $NF}')TRANSPORT_PORT=$(sureapp project list | grep -E 'portholder +'| awk '{print $NF}')sed -i "s~^#http.port: 9200~http.port: $ELASTIC_PORT\ntransport.port: $TRANSPORT_PORT-$TRANSPORT_PORT~g" /home/$USER/private/elastic/config/elasticsearch.ymlАко желаете да направите тези промени ръчно, ще трябва да видите портовете на "elastic" и "portholder" проектите в раздел "Уеб приложения" на хостинг Контролния панел. След това заместете следния ред с код във файла "config/elasticsearch.yml" на Elasticsearch проекта (напр. "~/private/elastic/config/elasticsearch.yml"):#http.port: 9200със следните два реда код, като в тях заместите "ELASTIC_PORT" с порта на "elastic" проекта, а "TRANSPORT_PORT" с порта на "portholder" проекта:http.port: ELASTIC_PORTtransport.port: TRANSPORT_PORT-TRANSPORT_PORTВ дадения пример "elastic" проекта е с порт 10095, а порта на "portholder" проекта е 8822, така че добавените два реда код ще изглеждат така:http.port: 10095transport.port: 8822-8822Можете да направите тези ръчни промени във файла чрез редактор по Ваш избор (напр. раздел "Файлове" на хостинг Контролния панел). Стартирайте "elastic" проекта чрез следната SSH команда или чрез бутона с иконка на червен кръг () до него в раздел "Уеб приложения" на хостинг Контролния панел.sureapp service manage --enable elastic Изчакайте няколко минути, за да се стратира приложението. След това можете да проверите дали Elasticsearch работи правилно, отваряйки страницата, която сте избрали в стъпка №6. Можете да използвате и следната "curl" команда, за да достъпите проекта директно на порта на Elasticsearch приложението (напр. 10095): curl localhost:10095Трябва да видите подобен на следния резултат:{  "name" : "your_server.com",  "cluster_name" : "elasticsearch",  "cluster_uuid" : "kOp_Sfh1TLWtMqodS3J97A",  "version" : {    "number" : "7.17.21",    "build_flavor" : "default",    "build_type" : "tar",    "build_hash" : "d38e4b028f4a9784bb74de339ac1b877e2dbea6f",    "build_date" : "2024-04-26T04:36:26.745220156Z",    "build_snapshot" : false,    "lucene_version" : "8.11.3",    "minimum_wire_compatibility_version" : "6.8.0",    "minimum_index_compatibility_version" : "6.0.0-beta1"  },  "tagline" : "You Know, for Search"}

В тази статия можете да откриете инструкции за инсталиране и стартиране на сървър за бази данни InfluxDB чрез WebApps платформата. InfluxDB базите данни са проектирани за събиране, съхранение, обработка и визуализация на данни, които са свързани с определен момент от време. Такъв тип бази данни се казват бази данни за времеви серии (Time Series Database - TSDB). Те са изключително удобни за анализирането на събития/данни в хронологичен ред, като данни може да се събират едновременно от различни източници. По-долу можете да откриете няколко примери за данни, които може да се съхраняват в този тип бази: Данни от индустриални сензори Цени от стоковата борса Електрическа активност в мозъка Измервания за валежи Данни за производителност на сървъри Ако желаете да научите повече за InfluxDB базите данни, можете да разгледате официалната документация. Има и бази данни, които могат да се използват за обработката на такива данни чрез специална настройка. Например MongoDB може да се настрои за работа с данни за времеви серии. Подготовка Преди да инсталирате InfluxDB на Вашия акаунт, трябва да проверите и настроите акаунта си за следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Инсталиране Свържете се към Вашия акаунт чрез SSH и следвайте тези стъпки: Създайте директория, в която да инсталирате файловете на InfluxDB (напр. "~/private/influxdb") и влезте в нея, като използвате следните команди:mkdir /home/$USER/private/influxdbcd /home/$USER/private/influxdb Изтеглете на Вашия акаунт бинарния файл за Linux за последната версия на InfluxDB от официалната страница. В момента на писане на тази статия, последната версия е 2.7.6, а линкът за изтегляне на тази версия е https://download.influxdata.com/influxdb/releases/influxdb2-2.7.6_linux_amd64.tar.gz. За изтегляне на тази версия и декомпресирането на архива във Вашата директория за InfluxDB можете да използвате тези команди:wget https://download.influxdata.com/influxdb/releases/influxdb2-2.7.6_linux_amd64.tar.gztar zxf influxdb2-2.7.6_linux_amd64.tar.gz --strip-components=1rm influxdb2-2.7.6_linux_amd64.tar.gzВажно: Уверете се, че използвате линка за последната версия на InfluxDB за Linux в горните команди. Използвайте следните команди, за да създадете файл, който стартира InfluxDB приложението при стартиране на WebApps проекта, и да му добавите права за изпълнение:cat <<INFLUXDB_START > /home/$USER/private/influxdb/start.sh#!/bin/bash/home/$USER/private/influxdb/usr/bin/influxd --bolt-path /home/$USER/private/influxdb/influxd.bolt --engine-path /home/$USER/private/influxdb/engine --http-bind-address :\$PORTINFLUXDB_STARTchmod +x /home/$USER/private/influxdb/start.sh Създайте WebApp проект за InfluxDB приложението чрез следната surapp CLI команда:sureapp project create \    --engine "custom" \    --engine-version "-" \    --release-dir "/home/$USER/private/influxdb/" \    --start-cmd "sh /home/$USER/private/influxdb/start.sh" \    influxdb Изберете адрес, на която да е достъпно InfluxDB приложението чрез раздел "Уеб приложения" на хостинг Контролния панел. Можете да направите това, като кликнете на бутона с иконка на молив () до проекта "influxdb" и изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран. Използвайте бутона с иконка на червен кръг () до приложението, за да го стартирате. Отворете избрания от Вас адрес за InfluxDB приложението (напр. http://influxdb.example.com) и следвайте стъпките на екрана, за да завършите инсталацията.

В тази статия ще откриете инструкции за инсталиране и стартиране на Grafana чрез WebApps платформата. Grafana е приложение с отворен код за мониторинг и анализ. Повече информация за това приложение е налична в официалната му документация. Подготовка Преди да инсталирате Grafana на Вашия акаунт, трябва да проверите и настроите акаунта си за следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Инсталиране За да инсталирате Grafana, се свържете към Вашия акаунт чрез SSH и следвайте тези стъпки: Създайте директорията, в която желаете да инсталирате файловете на Grafana (напр. "~/private/grafana") и влезте в тази директория, като използвате следните команди:mkdir /home/$USER/private/grafanacd /home/$USER/private/grafana Изтеглете на Вашия акаунт OSS бинарния файл за Linux (Standalone Linux Binaries) за последната версия на Grafana от официалната страница. В момента на писане на тази статия, последната версия е 10.4.2. Линкът за изтегляне на тази версия е https://dl.grafana.com/enterprise/release/grafana-enterprise-10.4.2.linux-amd64.tar.gz, така че можете да я изтеглите и разархивирате във Вашата директория за Grafana с тези команди:wget https://dl.grafana.com/enterprise/release/grafana-enterprise-10.4.2.linux-amd64.tar.gztar -zxf grafana-enterprise-10.4.2.linux-amd64.tar.gz --strip-components=1rm grafana-enterprise-10.4.2.linux-amd64.tar.gzВажно: Уверете се, че използвате линка за последната версия на Grafana за Linux в горните команди. Създайте файл, който да стартира Grafana приложението, при стартиране на WebApps проекта и му добавете права за изпълнение чрез следните команди:cat <<GRAFANA_START > /home/$USER/private/grafana/start.sh#!/bin/bashexport GF_SERVER_HTTP_PORT=\$PORT/home/$USER/private/grafana/bin/grafana server --homepath /home/$USER/private/grafanaGRAFANA_STARTchmod +x /home/$USER/private/grafana/start.sh Създайте WebApp проект за Grafana приложението използвайки следната команда:sureapp project create \    --engine "custom" \    --engine-version "-" \    --release-dir "/home/$USER/private/grafana/" \    --start-cmd "sh /home/$USER/private/grafana/start.sh" \    grafana Изберете страницата, на която да е достъпно Grafana приложението чрез раздел "Уеб приложения" на хостинг Контролния панел. Можете да направите това, като кликнете на бутона с иконка на молив () до проекта "grafana" и изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран. Стартирайте приложението чрез бутона с иконка на червен кръг () до него. Отворете избрания от Вас адрес за Grafana приложението (напр. http://grafana.example.com) и трябва да видите екрана за достъп до неговия административен панел. Можете да използвате "admin" за потребителско име и парола, като Ви съветваме да промените паролата при първа възможност.

"Redis" е система за съхранение на данни в кеш паметта, поддържаща различни видове данни - списъци, низове, асоциативни масиви и т.н. Той може да подобри производителността на сайтове, работещи с бази данни, като кешира информацията, върната от базите данни, директно в паметта на сървъра по модела ключ-стойност. Тъй като предоставя по-бърз достъп до често използвани данни, Redis може да повлияе положително на времето за зареждане на Вашия сайт или приложение. Повече информация за Redis е налична в официалната документация. Важно: Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да се свържете с нашия екип за повече информация и съдействие. В тази статия ще покажем как да настроите Redis като WebApps проект и да го използвате в няколко стъпки: Инсталиране на Redis чрез SSH и sureapp CLI инструмента или хостинг Контролния панел. Включване на поддръжка за Redis за PHP версията на Вашия сайт. Активиране на Redis кеширане във Вашето приложение или сайт WordPress Joomla След като инсталирате Redis, ще можете да го достъпвате чрез сокет на "/home/example/private/redis/redis.sock" във Вашия сайт или приложение. Не забравяйте да заместите "example" с потребителското име на Вашия хостинг акаунт. Проверка за наличие на Redis Redis е наличен по подразбиране за някои хостинг планове. Можете да проверите дали е наличен за Вашия акаунт, изпълнявайки следната команда, след като се свържете с Вашия акаунт чрез SSH:redis-cli ping && echo "Redis is available!"Ако Redis е наличен по подразбиране за Вашия акаунт, ще се покаже съобщение "Redis is available!". Redis работи локално на сървъра (с IP адрес 127.0.0.1) на порта по подразбиране за Redis (6379). Инсталиране на Redis като WebApps проект чрез SSH Можете да инсталирате Redis на Вашия акаунт като WebApps проект чрез SSH, следвайте тези стъпки: Установете SSH връзка с Вашия акаунт. Създайте директорията (/home/$USER/private/redis) и конфигурационен файл (/home/$USER/private/redis/redis.conf) за Redis. Можете да направите това със следния блок код:sureapp_project="redis"redis_dir="/home/$USER/private/redis"mkdir -pv "$redis_dir"cat <<REDIS_CONF > $redis_dir/redis.confunixsocket $redis_dir/redis.sockunixsocketperm 700port 0daemonize nostop-writes-on-bgsave-error nordbcompression yesmaxmemory 64M# how redis will evict old objects - least recently usedmaxmemory-policy allkeys-lruREDIS_CONF Създайте WebApps проект за Redis:sureapp project create \    --engine "custom" \    --engine-version "-" \    --release-dir "$redis_dir" \    --start-cmd "/usr/bin/redis-server $redis_dir/redis.conf" \    "$sureapp_project" Активирайте проекта:sureapp service manage --enable "$sureapp_project" Можете да проверите дали успешно сте активирали Redis и дали той работи, използвайки следната команда:redis-cli -s "$redis_dir/redis.sock" pingСлед изпълнение на командата, трябва да получите резултат "PONG", който индикира, че Redis работи успешно. Инсталиране на Redis като WebApps проект чрез Контролния панел Можете да инсталирате Redis като WebApps проект, използвайки Вашия Контролен панел > раздел "Уеб приложения". Влезте във Вашия хостинг Контролен панел > раздел "Файлове". Отидете в директория "Private" ("Лични файлове") и създайте нова директория за Вашия проект (напр. "/home/example/private/redis", като заместите "example" с потребителско име на Вашия хостинг акаунт). Влезте в новосъздадената директория и създайте нов файл с име "redis.conf" със следното съдържание:unixsocket /home/example/private/redis/redis.sockunixsocketperm 700port 0daemonize nostop-writes-on-bgsave-error nordbcompression yesmaxmemory 64M# how redis will evict old objects - least recently usedmaxmemory-policy allkeys-lruВажно: Заместете "example" с потребителското име на Вашия хостинг акаунт и "/private/redis/" с директорията, която сте подготвили за Redis. Отидете в раздел "Уеб приложения" на хостинг Контролния панел. Използвайте следните данни във формата за създаване на ново приложение:Платформа - изберете "Custom".Име - изберете име за Вашето приложение (напр. "redis").Домейн - от падащото меню изберете домейн.Поддомейн - от падащото меню изберете поддомейн.Уеб път за достъп - въведете несъществуваща директория/път (напр. "/izmislena-papka/redis/"). Ако има същестуващ файл или директория със същото име, те може да спрат да работят.Директория на приложението - въведете директорията, в която ще инсталирате Redis (напр. "/private/redis").Команда за стартиране - въведете "/usr/bin/redis-server /home/example/private/redis/redis.conf", като трябва да заместите "example" с потребителското име на Вашия хостинг акаунт, а "/private/redis/" с директорията, която сте избрали за приложението. Натиснете бутона "Създай". Включете приложението, като използвате бутона с иконка на червен кръг (). Активиране на Redis разширението за PHP скриптове След успешното инсталиране на Redis като уеб приложение, трябва да добавите поддръжка за него в PHP скриптовете на сайта Ви. За да направите това, трябва да отидете в раздел "PHP настройки" на Вашия хостинг Контролен панел и натиснете бутона "Промени" за сайта Ви. Така ще отидете в страницата за управление на неговите PHP настройки, където трябва да сложите отметка за разширението "redis" и да натиснете бутона "Запази". Активиране на Redis кеширане във Вашето приложение или сайт Последната стъпка в използването на Redis е да го активирате във Вашето приложение или сайт, като окажете пътя към Redis сокета в настройките за Redis на приложението, което използвате. Ако Вашето потребителско име е "example" и сте инсталирали Redis в директория "/private/redis/" на Вашия акаунт, тогава сокета за Redis ще бъде:/home/example/private/redis/redis.sockДетайлни инструкции за активиране на Redis за различните приложения и скриптове трябва да бъдат достъпни в тяхната онлайн документация. В противен случай можете да се допитате до разработчиците на тези приложения и скриптове за помощ с активиране на Redis. WordPress и Redis За използване на Redis в WordPress, трябва да инсталирате разширение за WordPress, което има поддръжка за Redis. За пример ще използваме приложението "LiteSpeed Cache" за WordPress. След като го инсталирате на Вашия WordPress сайт, трябва да : Влезете в таблото за управление на WordPress като администратор. Отворите екрана "Cache" на разширението "LiteSpeed Cache". Отидете в таб "[6] Object". Включите "Object Cache" (кеширане на обекти). Попълните сокета на Вашата Redis инсталация (напр. "/home/example/private/redis/redis.sock"). Запазите промените с натискане на бутона "Save Changes". След запазването на промените, трябва информацията в "Status" да индикира, че Redis разширението е включено ("Redis Extension: Enabled") и тестовата връзка е преминала успешно ("Connection Test: Passed"). Друг пример за приложение за WordPress, което поддържа Redis, е "Redis Object Cache". За настройка на приложението трябва само да добавите следните редове във wp-config.php файла на Вашата WordPress инсталация, които указват пътя до Redis сокета на Вашето приложение (напр. /home/example/private/redis/redis.sock):define( 'WP_REDIS_SCHEME', 'unix' );define( 'WP_REDIS_PATH', '/home/example/private/redis/redis.sock' );След запазване на промените в конфигурационния файл, в екрана на разширението в административното табло за управление на Вашата WordPress инсталация ще можете да активирате Redis кеширането: Joomla и Redis За да включите поддръжка на Redis за кеширане в Joomla версия 5, следвайте тези лесни стъпки: Влезте в таблото за управление на Joomla като администратор. Отворете екрана с глобалните настройки на Joomla ("System" > "Setup" > "Global Configuration"). Отидете в таб "System". В раздел "Cache": изберете "ON - Conservative caching" или "ON - Progressive caching" за "System Cache", изберете "Redis" за "Cache Handler" и попълнете сокета на Вашата Redis инсталация (напр. "/home/example/private/redis/redis.sock") в полето "Redis Server Host/Sock". Натиснете бутона "Save" или "Save & Close", за да запазите настройките.

В тази статия ще откриете инструкции за настройка на Django проект във Вашия хостинг акаунт, който използва PostgreSQL за база данни чрез платформата за уеб приложения WebApps. Подготовка Преди да инсталирате Django на Вашия акаунт, трябва да проверите и настроите следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате такъв раздел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Бърза настройка Ако искате да настроите своя Django проект бързо, първо трябва да създадете PostgreSQL сървър. Препоръчваме Ви да използвате shell скрипта от раздел "Бърза настройка". Той ще настрои Вашия PostgreSQL сървър с нужните данни за инсталиране на Django. След като PostgreSQL работи на Вашия акаунт, изтеглете скрипта за инсталиране на Django на Вашия акаунт и го изпълнете. Скриптът ще настрои WebApps проект за Вашия Django сайт. Имайте предвид, че скриптът за инсталиране на Django автоматично ще настрои PostgreSQL данни за Вашето Django приложение, така че няма да се наложи да го правите ръчно. За целта, изпълнете двата скрипта последователно: # Set up PostgreSQL setup_postgresql.sh # This sets up $PGHOST in the shell environment . ~/.bashrc # Set up Django mv 4867.sh setup_django.sh chmod 755 setup_django.sh ./setup_django.sh В този случай можете директно да преминете към раздел "Пускане на Django сайт" на тази статия. Инсталиране Преди да започнете инсталацията трябва да се уверите, че сте настроили и активирали PostgreSQL сървър на Вашия акаунт и променливата за средата "$PGHOST" е настроена във Вашата конзола. Повече информация за настройката на PostgreSQL сървър можете да намерите в статията ни "Използване на PostgreSQL". Следващата стъпка е създаването на директория за Вашия нов Django сайт: sureapp_project="django1" django_project_dir="/home/$USER/private/$sureapp_project" mkdir -p "$django_project_dir/sureapp" След това настройте база с данни: [ -z "$PGHOST" ] && . /home/$USER/.bashrc if [ -n "$PGHOST" ] then pguser="$sureapp_project" pgpass="$(pwgen 24 1)" pgdb="${sureapp_project}_db" printf "CREATE ROLE %s PASSWORD '%s' NOSUPERUSER NOCREATEDB NOCREATEROLE INHERIT LOGIN;" "$pguser" "$pgpass" | psql postgres createdb --owner "$pguser" "$pgdb" && printf "Database %s created successfully.\n" "$pgdb" fi virtualenv Django работи чрез Python, за който е добре да се създава изолирана среда за всяко отделно приложение. Можете да направите това чрез virtualenv: mkdir -p "/home/$USER/.local/bin" grep -q '^PATH=.*/.local/bin' "/home/$USER/.bashrc" || printf '\nPATH="/home/%s/.local/bin:$PATH"\nexport PATH\n' "$USER" >> "/home/$USER/.bashrc" PATH="/home/$USER/.local/bin:$PATH" export PATH pip3 install virtualenv virtualenv --system-site-packages -p /usr/bin/python3 "$django_project_dir/venv" . "$django_project_dir/venv/bin/activate" По този начин всички нужни Python скриптове за приложението Ви ще се използват само за конкретния проект. Нужни Python скриптове Инсталирайте всички нужни Python скриптове за Вашия Django сайт: pip3 install psycopg2 whitenoise gunicorn Django psycopg2 е адаптер за PostgreSQL бази данни; whitenoise е статичен файлов сървър, който е изключително удобен за Django; gunicorn е много сигурен и производителен WSGI сървър; Django е пакетът, който включва Django работната среда. Django проект Следващата стъпка е да настроите Вашия Django проект: django-admin startproject "$sureapp_project" "$django_project_dir" django_project_settings_file="$django_project_dir/$sureapp_project/settings.py" sed -i 's/^DEBUG = .*/DEBUG = False/' "$django_project_settings_file" sed -i "s/^ALLOWED_HOSTS = .*/ALLOWED_HOSTS = ['*']/" "$django_project_settings_file" cat <<POSTGRES_CONFIG >> "$django_project_settings_file" DATABASES['default'] = { 'ENGINE': 'django.db.backends.postgresql', 'NAME': '$pgdb', 'USER': '$pguser', 'PASSWORD': '$pgpass', 'HOST': '$PGHOST', } POSTGRES_CONFIG cat <<STATICFILES_CONF >> "$django_project_settings_file"import os STATIC_ROOT = os.path.join(BASE_DIR, 'static') MIDDLEWARE.append('whitenoise.middleware.WhiteNoiseMiddleware') STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage' STATICFILES_CONF python3 "$django_project_dir/manage.py" migrate python3 "$django_project_dir/manage.py" collectstatic Създаване на WebApps проект Създайте WebApps проект за Django чрез следната sureapp команда: sureapp project create \ --engine "custom" \ --engine-version "-" \ --release-dir "$django_project_dir/sureapp" \ --start-cmd "$django_project_dir/start.sh" \ "$sureapp_project" Тази стъпка е необходима, защото от нея ще се определи порта за Вашия Django проект. WSGI сървър Gunicorn е сигурен и производителен WSGI сървър. Най-лесният начин да го настроите е чрез използването на стартов скрипт: wsgi_port="$(sureapp project list | grep "$sureapp_project" | awk '{print $5}')" cat <<START_SH > "$django_project_dir/start.sh" #!/bin/sh cd "$django_project_dir" . "$django_project_dir/venv/bin/activate" exec gunicorn -b "127.0.0.1:$wsgi_port" -w 4 "$sureapp_project.wsgi:application" START_SH chmod 0700 "$django_project_dir/start.sh" Скрипт за управление Въпреки че не е задължително, създавайки скрипт за управление на Django приложението Ви, ще улесните извършването на промени по Django приложението чрез командния ред много по-лесно. Скриптът ще взима и ще се съобразява с настройките на настроена среда за Django, така че да не се налага да правите това ръчно всеки път, когато искате да използвате manage.py скрипта в инсталационната директория на Django. cat <<MANAGE_SH > "$django_project_dir/manage.sh" #!/bin/sh . "$django_project_dir/venv/bin/activate" exec python3 "$django_project_dir/manage.py" "\$*" MANAGE_SH chmod 0700 "$django_project_dir/manage.sh" ln -s "$django_project_dir/manage.sh" "/home/$USER/.local/bin/manage-$sureapp_project" С този скрипт за управление можете да се свържете с акаунта си чрез SSH и директно да използвате командата в директорията на Вашия Django проект. Ако Вашият Django проект се казва "django1" (както е в дадения пример), можете да използвате следната команда, за да видите наличните опции за управление: manage-django1 help Този скрипт ще бъде наличен за Вашето Django приложение, ако сте използвали скрипта за бърза настройка. Пускане на Django сайт WebApps проект Завършете настройката на WebApps проекта, за да зададете URL адреса, на който да е достъпно Django приложението. Тъй като WebApps проектът е вече създаден, използвайте бутона с иконка на молив () до проекта "django1" и изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран: Ако искате да използвате Django приложението в отделен поддомейн, първо трябва да го създадете през раздел "Поддомейни" на хостинг Контролния панел. Стартирайте приложението чрез бутона с иконка на червен кръг () до него.   Влизане в Django За да създадете нов потребител с административни права за Вашия Django проект (напр. с име "django1"), използвайте следната команда чрез скрипта за управление, описан по-рано в статията: manage-django1 createsuperuser След успешното задаване на изисканите данни, ще можете да влезете като администратор с тях във Вашия нов Django сайт. Можете да достъпите административния интерфейс на Django на избрания адрес (домейн/поддомейн) за WebApps проекта, добавяйки "/admin". Ако сте настроили Django да работи на "http://django.example.com", административния интерфейс ще е достъпен на "http://django.example.com/admin/".

React, ReactJS или React.js е популярна JavaScript библиотека за създаване на интерактивни потребителски интерфейси. Той може да се инсталира изключително лесно чрез една SSH команда, след като сте влезли във Вашия проект чрез sureapp CLI инструмента:npm install reactВажно: Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да се свържете с нашия екип за повече информация и съдействие. В тази статия ще Ви покажем как да настроите и създадете примерно React приложение (калкулатор), използвайки npm и serve. Можете да използвате същите стъпки и за инсталиране на най-актуалното ръководство за React - морски шах. За целта трябва да се свържете към Вашия акаунт чрез SSH и да следвате тези стъпки: Създайте директорията, в която желаете да инсталирате файловете на React приложението (напр. "~/private/react-calculator") и влезте в тази директория, като използвате следната команда:mkdir /home/$USER/private/react-calculator && cd /home/$USER/private/react-calculator Изтеглете файловете за примерното React приложение от GitHub в новосъздадената директория:git clone https://github.com/andrewagain/calculator.git "/home/$USER/private/react-calculator" Създайте WebApps проект за React калкулатора с име "react-calculator" чрез следната команда на sureapp CLI инструмента:sureapp project create \ --engine node \ --engine-version lts \ --release-dir "/home/$USER/private/react-calculator" \ react-calculator Влезте в WebApps проекта със следната sureapp CLI команда:sureapp project shell react-calculator Използвайте следната команда, за да се инсталират всички необходими за проекта Node.js пакети:npm installПроцесът може да отнеме повече време. Тъй като даденият пример в проекта използва остарял протокол, добавете поддръжка за него с тези команди в конзолата: sed -i 's~^    "build": "react-scripts build",~    "build": "react-scripts --openssl-legacy-provider build",~g' package.json sed -i 's~^    "start": "react-scripts start",~    "start": "react-scripts --openssl-legacy-provider start",~g' package.json Изпълнете следната команда, за да стартирате тестов сървър за React калкулатора: npm start Изберете страницата, на която да е достъпен React калкулатора, в раздел "Уеб приложения" на хостинг Контролния панел. Можете да направите това, като кликнете на бутона с иконка на молив () до проекта "react-calculator" и изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран.За да запазите промените, използвайте бутона "Промени". Oтворете избрания в предишната стъпка адрес на проекта (напр. http://calculator.example.com), като можете директно да използвате линка от колоната "Адрес" на Вашия React проект. Трябва да бъдете пренасочени към страница с калкулатор. След като сте се уверили, че Вашият проект е успешен и калкулаторът работи, отново се върнете в конзолата на Вашия WebApps проект и спрете тестовия сървър. Можете да направите това, като спрете SSH командата за тестовия сървър с комбинацията от клавиши Ctrl+C. За да стартирате продуктов сървър за проект, трябва първо да промените адреса на калкулатора ("homepage") във файла package.json на проекта от "http://ahfarmer.github.io/calculator" на адреса, който сте избрали за WebApps проекта. Ако проектът Ви използва адрес "http://calculator.example.com", тогава въведете него.С командата по-долу настройваме "/" за адрес, тъй като желаем винаги да се зарежда калкулатора, дори и при опит за отваряне на несъществуващ файл или директория на адреса на проекта: sed -i 's~^  "homepage": "http://ahfarmer.github.io/calculator",~  "homepage": "/",~g' package.json Създайте статично копие на сайта със следната команда: npm run build Инсталирайте "serve" Node.js пакета и пуснете продуктов сървър със следните команди: npm install -g serve serve -s build Отново отворете адреса на проекта (напр. http://calculator.example.com), като можете директно да използвате линка от колоната "Адрес" на Вашия React проект от раздел "Уеб приложения" на хостинг Контролния панел. Ако приложението работи правилно, можете да спрете продуктовия сървър чрез комбинацията от клавишите Ctrl+C. Настройте командата "serve -s build" като стартова команда за Вашия React проект и активирайте приложението. Можете да направите това от раздел "Уеб приложения" на хостинг Контролния панел или чрез следните команди на sureapp CLI инструмента: sureapp project modify --start-cmd "serve -s build" sureapp service manage --enable

"Memcached" е дистрибутирана система за съхранение на данни в кеш паметта. Тя подобрява производителността на сайтове, които работят с бази данни, като кешира данни, върнати от базите данни, директно в паметта на сървъра по модела ключ-стойност. Memcached може да подобри времето за зареждане на Вашия сайт или приложение, предоставяйки по-бърз достъп до данни, които се достъпват редовно. Повече информация за Memcached е налична в официалната документация. Важно: Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да се свържете с нашия екип за повече информация и съдействие. В тази статия ще покажем как да настроите Memcached като WebApps проект и да го използвате в няколко стъпки: Инсталиране на Memcached чрез SSH и sureapp CLI инструмента или хостинг Контролния панел. Включване на поддръжка за Memcached за PHP версията на Вашия сайт. Активиране на Memcached кеширане във Вашето приложение или сайт WordPress Joomla След инсталирането, Memcached ще бъде достъпен на "/home/example/private/memcached/memcached.sock" като сокет за Memcached на Вашия сайт или във Вашето приложение. Разбира се, ще трябва да заместите "example" с потребителското име на Вашия хостинг акаунт. Проверка за наличие на Memcached Memcached е наличен по подразбиране за някои хостинг планове. Можете да проверите дали е наличен за Вашия акаунт, изпълнявайки следната команда, след като се свържете с Вашия акаунт чрез SSH:telnet localhost 11211Ако Memcached е наличен по подразбиране за Вашия акаунт, ще се покаже съобщение "Connected to localhost.", което означава, че Memcached работи локално на сървъра (с IP адрес 127.0.0.1) на порта по подразбиране за Memcached (11211). За да прекратите тестовата връзка към Memcached сървъра, използвайте командата "quit". Инсталиране на Memcached като WebApps проект чрез SSH За да инсталирате Memcached на Вашия акаунт като WebApps проект чрез SSH, следвайте тези стъпки: Установете SSH връзка с Вашия акаунт. Създайте директорията за Memcached проекта:mkdir /home/$USER/private/memcached Създайте проекта:sureapp project create \    --engine custom \    --engine-version - \    --release-dir "/home/$USER/private/memcached" \    --start-cmd "/usr/bin/memcached -m 64 -s /home/$USER/private/memcached/memcached.sock -a 700 -c 256"\    memcached Активирайте проекта:sureapp service manage --enable memcached Инсталиране на Memcached като WebApps проект чрез Контролния панел > раздел "Уеб приложения" Можете да инсталирате Memcached като WebApps проект, използвайки Вашия Контролен панел > раздел "Уеб приложения". Влезте в раздел "Уеб приложения" на Вашия хостинг Контролен панел. Във формата за създаване на ново приложение използвайте следните данни:Платформа - изберете "Custom".Име - изберете име за Вашето приложение (напр. "memcached").Домейн - от падащото меню изберете домейн по Ваше усмотрение.Поддомейн - от падащото меню изберете поддомейн по Ваше усмотрение.Уеб път за достъп - въведете несъществуваща директория/път (напр. "/izmislena-papka/memcached/"). Ако има същестуващ файл или директория със същото име, те може да спрат да работят.Директория на приложението - въведете директорията, в която ще инсталирате Memcached (напр. "/private/memcached").Команда за стартиране - въведете "/usr/bin/memcached -m 64 -s /home/example/private/memcached/memcached.sock -a 700 -c 256", като трябва да заместите "example" с потребителското име на Вашия хостинг акаунт, а "/private/memcached/" с директорията, която сте избрали за приложението. Натиснете бутона "Създай". Включете приложението, като използвате бутона с иконка на червен кръг (). Активиране на Memcached разширението за PHP скриптове След като сте инсталирали Memcached като уеб приложение, трябва да добавите поддръжка за него в PHP скриптовете на сайта Ви. За целта отидете в раздел "PHP настройки" на Вашия хостинг Контролен панел и натиснете бутона "Промени" за сайта Ви. Така ще отидете в страницата за управление на неговите PHP настройки, където трябва да сложите отметка за разширението "Memcached" и да натиснете бутона "Запази". Активиране на Memcached кеширане във Вашето приложение или сайт Последната стъпка в използването на Memcached е да го активирате във Вашето приложение или сайт. За целта трябва да окажете пътя към Memcached сокета в настройките за Memcached на приложението, което използвате. Ако Вашето потребителско име е "example" и сте инсталирали Memcached в директория "/private/memcached/" на Вашия акаунт, тогава сокетът за Memcached ще бъде:/home/example/private/memcached/memcached.sockДетайлни инструкции за активиране на Memcached за различните приложения и скриптове трябва да бъдат достъпни в тяхната документация. В противен случай можете да се допитате до разработчиците на тези приложения и скриптове за помощ с активиране на Memcached. WordPress и Memcached За използване на Memcached в WordPress трябва да инсталирате разширение за WordPress, което има поддръжка за Memcached. За пример ще използваме приложението "LiteSpeed Cache" за WordPress. След като го инсталирате на Вашия WordPress сайт, трябва да : Влезете в таблото за управление на WordPress като администратор. Отворите екрана "Cache" на разширението "LiteSpeed Cache". Отидете в таб "[6] Object". Включите "Object Cache" (кеширане на обекти). Попълните сокета на Вашата Memcached инсталация (напр. "/home/example/private/memcached/memcached.sock"). Запазите промените с натискане на бутона "Save Changes". След запазването на промените, трябва информацията в "Status" да индикира, че Memcached разширението е включено ("Memcached Extension: Enabled") и тестовата връзка е преминала успешно ("Connection Test: Passed"). Joomla и Memcached За да включите поддръжка на Memcached за кеширане в Joomla версия 5, последвайте тези лесни стъпки: Влезте в таблото за управление на Joomla като администратор. Отворете екрана с глобалните настройки на Joomla ("System" > "Setup" > "Global Configuration"). Отидете в таб "System". В раздел "Cache": изберете "ON - Conservative caching" или "ON - Progressive caching" за "System Cache", изберете "Memcached (Experimental)" за "Cache Handler" и попълнете сокета на Вашата Memcached инсталация (напр. "/home/example/private/memcached/memcached.sock") в полето "Memcache(d) Server Host". Натиснете бутона "Save" или "Save & Close", за да запазите настройките.

В тази статия ще Ви покажем как да инсталирате сървъра за автоматизация с отворен код "Jenkins" на Вашия акаунт. Можете да видите какви промени трябва да направите на Вашия акаунт, как да инсталирате Jenkins и как да настроите Jenkins да работи винаги по HTTPS. Важно: Инструкциите в тази статия са изпробвани с Jenkins версия с дългосрочна поддръжка (LTS) 2.440.1 и Java Development Kit (JDK) версия 21.0.2. Подготовка Преди да инсталирате Jenkins на Вашия акаунт, трябва да проверите и настроите акаунта си за следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" и "Мрежови инструменти" трябва да са активирани за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Инсталиране За да инсталирате Jenkins, трябва да се свържете към Вашия акаунт чрез SSH и да следвате тези стъпки: Създайте директорията, в която желаете да инсталирате файловете на Jenkins (напр. "~/private/jenkins") и влезте в тази директория, като използвате следната команда:mkdir /home/$USER/private/jenkins && cd /home/$USER/private/jenkins Изтеглете на Вашия акаунт пакета Generic Java package (.war) за Jenkins от официалната страница. В момента на писане на тази статия, последната версия с дългосрочна поддръжка (LTS) е 2.440.1. Линкът за изтегляне на тази версия е https://get.jenkins.io/war-stable/2.440.1/jenkins.war, така че можете да я изтеглите във Вашата директория за Jenkins с тази команда:wget https://get.jenkins.io/war-stable/2.440.1/jenkins.warВажно: Уверете се, че използвате линка за последната версия на Jenkins за Generic Java package (.war) и го използвате в горната команда. Текущата версия с дългосрочна поддръжка (LTS) за Jenkins изцяло поддържа Java 21, Java 11 и Java 17 (информация). Можете да изтеглите последната версия 21 на Java Development Kit (JDK) като x64 компресиран архив (x64 Compressed Archive) за Linux от официалната страница за изтегляне. Линкът за изтегляне на последната версия JDK 21 по времето на писане на тази статия е https://download.oracle.com/java/21/latest/jdk-21_linux-x64_bin.tar.gz, така че за изтеглянето ѝ като архив, може да използвате следната команда:wget https://download.oracle.com/java/21/latest/jdk-21_linux-x64_bin.tar.gz Изтегленият пакет за JDK 21 е компресиран архив, който трябва да разархивирате. В дадения пример, името на архива е "jdk-21_linux-x64_bin.tar.gz". Със следната команда можете да го разархивирате и след завършване на разархивирането да го изтриете:tar zxf jdk-21_linux-x64_bin.tar.gz && rm jdk-21_linux-x64_bin.tar.gz След това трябва да създадете WebApps проект за Jenkins. Можете да използвате sureapp CLI инструмента за създаване на проект с име "jenkins", използвайки тази команда:sureapp project create \    --engine custom \    --engine-version - \    --release-dir "/home/$USER/private/jenkins" \    jenkins Влезте във Вашия Jenkins проект, като използвате следната sureapp CLI команда:sureapp project shell jenkins Следващата стъпка е настройката на стартовата команда за проекта. Тъй като Jenkins ще работи с Java, трябва да откриете "java" командата в папката на JDK. За JDK версия 21 "java" командата се намира в директория "~/private/jenkins/jdk-21.0.2/bin/java", а стартовата команда за Jenkins проекта можете да настроите с тази команда:sureapp project modify --start-cmd "/home/$USER/private/jenkins/jdk-21.0.2/bin/java -Xmx768m -XX:MaxRAM=1024m -jar /home/$USER/private/jenkins/jenkins.war --httpPort=\$PORT --httpsPort=-1" --rlimit-as 2048000000Ако искате да използвате Jenkins в поддиректория на Вашия домейн/поддомейн (напр. "example.com/Jenkins"), тогава трябва да добавите мрежовия параметър "--prefix=Jenkins" към стартовата команда на Вашия проект.Важно: Ако Jenkins проектът се рестартира поради грешки заради недостиг на памет, можете да увеличите стойностите за настройкте "-Xmx768m" (максимален размер на паметта от Java) и "-XX:MaxRAM=1024m" (реален размер на паметта, която може да се използва за максимален размер от Java) на Java в стартовата команда, както и настройката "--rlimit-as 2048000000" (ограничение за памет на уеб приложението) на проекта. Препоръчваме да променяте тези лимити спрямо наличните ресурси за Вашия хостинг план. Настройте променлива за средата на проекта, която оказва директорията с файловете на Jenkins:sureapp env set JENKINS_HOME /home/$USER/private/jenkins Изберете URL страницата, на която да е достъпен Jenkins, чрез раздел "Уеб приложения" на хостинг Контролния панел. Можете да направите това, като кликнете на бутона с иконка на молив () до проекта "jenkins". Изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран. За да запазите промените, използвайте бутона "Промени". Стартирайте проекта с бутона "Включи", който е с иконка на червен кръг (). Използвайте бутона "Презареди", докато състоянието на проекта стане "ОК" и статусът му "Стартиран". Отворете URL адреса на Вашия Jenkins проект, който е показан в колона "Адрес", и ще бъдете пренасочени към екран със следното съдържание: На екрана "Отключване на Jenkins" ще откриете информация къде можете да откриете Вашата първоначална администраторска парола - във файла "~/private/jenkins/secrets/initialAdminPassword" на Вашия акаунт или в лог файловете на проекта. Можете да видите паролата от файла чрез изпълнение на следната SSH команда:cat /home/$USER/private/jenkins/secrets/initialAdminPasswordАко пък искате да видите паролата от логовете на Jenkins проекта, използвайте тази команда на sureapp CLI инструмента:sureapp log followВъведете паролата в екрана за отключване на Jenkins и следвайте стъпките на екрана, за да завършите процеса на инсталация. Вече можете да използвате Вашето Jenkins уеб приложение.   Задължително използване на HTTPS Jenkins се използва от потребителите след предоставяне на потребителско име и парола, така че Ви съветваме да активирате задължително използване на HTTPS за него. Всичко, което е необходимо да направите, е да активирате или инсталирате SSL сертификат на сървъра за домейна/поддомейна, използван от Jenkins и да натиснете бутона "Включи" до домейна/поддомейна в раздел "Пренасочване към HTTPS" на Контролния панел.

В тази статия можете да откриете инструкции за инсталиране и използване на Next.js с нашата WebApps платформа. Подготовка За да използвате Next.js, трябва да проверите и настроите акаунта си за следните неща: Трябва да имате раздел "Уеб приложения" във Вашия хостинг Контролен панел. Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да ни пишете за повече информация и съдействие. "SSH достъп" трябва да е активиран за Вашия акаунт през раздел "SSH Достъп" на Контролния панел. Инсталиране За да стартирате Next.js като уеб приложение, се свържете към Вашия акаунт чрез SSH и следвайте тези стъпки: Създайте директория за Next.js (напр. "~/private/nextjs") и влезте в нея, като използвате следните команди:mkdir /home/$USER/private/nextjscd /home/$USER/private/nextjs Създайте WebApps проект за Next.js (напр." next") чрез следната surapp CLI команда:sureapp project create \    --engine "node" \    --engine-version "lts" \    --release-dir "/home/$USER/private/nextjs/" \    next Влезте в Next.js приложението (напр. "next") с тази команда:sureapp project shell next Инсталирайте последната версия на Node.js мениджъра за пакети (npm):npm install -g npm@latest Създайте Next.js стартово приложение с шаблона по подразбиране чрез тази команда и изберете желаните от Вас опции за приложението, които ще се покажат на екрана:npx --yes create-next-app@latest . Създайте статично копие на Next.js приложението:npm run build Изберете адрес, на който да е достъпно Next.js приложението чрез раздел "Уеб приложения" на хостинг Контролния панел. Можете да направите това, като кликнете на бутона с иконка на молив () до проекта "next" и изберете домейна и поддомейна чрез съответните падащи менюта в показалия се екран. Активирайте Next.js уеб приложението (напр. "next") като натиснете бутона с иконка на червен кръг () до него или използвайте тази команда на sureapp CLI инструмента:sureapp service manage --enable next Отворете избрания от Вас адрес за Next.js приложението във Вашия браузър.

  В тази статия ще Ви покажем как да инсталирате мениджъра за управление на пакети "Yarn" в няколко лесни стъпки, използвайки WebApps платформата. Важно: Ако нямате раздел "Уеб приложения" във Вашия Контролен панел, тогава инструкциите в тази статия не са валидни за Вашия акаунт и сървър. Можете да се свържете с нашия екип за повече информация и съдействие. Свържете се към Вашия акаунт чрез SSH. Трябва да създадете директория, в която желаете да инсталирате файловете на Yarn (напр. "~/private/yarn"), както и да влезете в тази директория. Можете да използвате следната команда, за да направите това:mkdir /home/$USER/private/yarn && cd /home/$USER/private/yarn Създайте WebApps проект за Yarn, използвайки тази команда на sureapp CLI инструмента:sureapp project create \--engine node \--engine-version lts \--release-dir "/home/$USER/private/yarn" \yarnТака ще създадете проект с име "yarn", чиито файлове ще се намират в директория "/home/$USER/private/yarn". Влезте в "yarn" проекта със следната sureapp команда:sureapp project shell yarn Инсталирайте Yarn глобално за проекта с тази команда:npm install -g yarn Вече можете да използвате "yarn" в конзолата на Вашия проект. Например можете да стартирате нов Yarn проект със следната команда:yarn initМожете да добавяте и пакети, които са необходими за проекта. За да добавите пакета "lodash" към проекта, можете да използвате тази команда:yarn add lodash