ASP.NET е софтуерен уеб фреймуърк с отворен код, разработен от Microsoft. Той дава възможност на разработчиците да създават динамични уеб сайтове, уеб приложения и уеб услуги, като използват различни програмни езици, включително C#, Visual Basic и F#. ASP.NET предоставя голям набор от инструменти и функционалности, които опростяват уеб разработката, като вградена автентикация и авторизация, кеширане и управление на сесии.
ASP.NET (AlmaLinux 8)
- Операционна система: almalinux 8
Описание
Включен софтуер
Пакет | Версия |
---|---|
ASP.NET Core | 7 |
Docker | 3.20.10 |
Docker compose | 2.12.2 |
containerd.io | 1.6.10 |
Първоначално стартиране на услугата
Това приложение използва Docker, за да осигури по-бързо стартиране на прилежащия софтуер (ASP.NET Core) и директно започване на употребата му. По този начин се елиминира нуждата от запознаване със спецификите му по отношение на конфигурация и инсталация. За да започнете директна работа с приложението, единственото, което трябва да направите е да качите своето съдържание, което желаете да се обслужва от ASP.NET Core в директорията /opt/aspnet/data/
.
Бързи настройкии и често задавани въпроси
- Входът в клауд услугата се извършва посредством SSH ключ или парола, която сте посочили.
- Docker е инсталиран според препоръките от официалната docker документация.
- Стандартните команди
docker
иdocker compose
са вече достъпни в това приложение. - При първо стартиране на виртуалната машина, отнема няколко минути, преди да се стартира Docker контейнер, съдържащ ASP.NET Core.
- ASP.NET Core директорията, където трябва да разположите вашето приложение се намира в
/opt/aspnet/data/
.
Допълнителни настройки при Docker
Допълнителнителните настройки за ASP.NET, които можете да променяте и които се контролират директно от Docker са зададени като променливи стойности в конфигурационния файл /opt/docker-aspnet/docker-compose.yml
.
Забележка: След промяна на която и да е от стойностите, трябва да пресъздадете Docker контейнера, върху който работи приложението. За повече информация, моля, прочетете секцията за пресъздаване на Docker контейнери.
Допълнителни полезни съвети
- Ако желаете да ползвате .NET CLI, то можете да го направите с бързата команда
docker exec -ti docker-aspnet-aspnet-core-1 dotnet <COMMAND>
. - Ако ползвате често .NET Core CLI, то можете и да направите бърз shortcut чрез добавяне на alias по следния начин:
echo "alias dotnet='docker exec -ti docker-aspnet-aspnet-core-1 dotnet'" >> ~/.bashrc
source ~/.bashrc
Работа с Docker
Организацията на това приложение е осъществена изцяло посредством Docker. По този начин можем да Ви предоставим готови приложения по-бързо. Освен това, конфигурацията им е по-гъвкава и е доста контролируема. За да можете да контролирате това приложение обаче, е нужно да знаете някои базови Docker функционалности и особености.
Рестартиране на всички услуги
Рестартирането на базата данни и Docker контейнера, който съдържа самия ASP.NET Core, заедно с останалия софтуер, може да бъде извършено по два начина:
- Чрез рестартиране на цялата виртуална машина
- Рестартиране на Docker контейнерите, което е по-бързия вариант. За целта, достъпете машината си чрез SSH, и изпълнете следните команди:
sudo su -
cd /opt/docker-aspnet
docker compose restart
Пресъздаване на Docker контейнери
Пресъздаването може да се наложи, в случай че сме променяли конфигурацията в docker-compose.yml
. При тази ситуация, трябва да следвате следните стъпки:
cd /opt/docker-aspnet/
docker compose stop
docker compose up -d
Проверка на статуса на Docker приложението
За да направите проверка, трябва да изпълните следните команди:
sudo su -
docker ps -a
Моля, обърнете внимание на колоната STATUS
. Тя трябва да показва от колко време работи услугата, например Up X minutes
. Ако статуса е Restarting
, то трябва да се провери какво не е наред с приложението. В такъв случай, можете да направите проверка, като проследите логовете на приложението по следния начин:
- Вземете името на приложението, което можете да видите в колоната
NAMES
от изходния код на командатаdocker ps -a
. Вижте логовете с командатаdocker logs <NAME>
, Къдетое името на контейнера.
Промяна на настройки
Описаните настройки в секцията Допълнителни настройки при Docker могат да бъдат нагласяни в docker-compose.yml файлът. Пътят до него е описан отново в тази секция. За да промените настройка, отворете конфигурационния файл и променете опцията, която Ви интересува. Всяка една конфигурационна опция трябва да бъде описана на нов ред, със съответната идентация с тире отпред по следния примерен начин:
environment:
- APACHE_HTTP_PORT_NUMBER=8080
Моля, обърнете внимание, че трябва да се спазва и правилната индентация (брой празно място), тъй като това е важно за конфигурационни файлове от тип yaml.