Feature/nodejs (#397)

* Add node support using nvm

* Add icon

* Rename to NodeJS

* Rename to NodeJS

* update php and node logo

* only services which have units can be started,restarted,stopped,disabled and enabled

* add tests

---------

Co-authored-by: Saeed Vaziry <mr.saeedvaziry@gmail.com>
Co-authored-by: Saeed Vaziry <61919774+saeedvaziry@users.noreply.github.com>
This commit is contained in:
Mark Topper
2024-12-24 17:49:27 +01:00
committed by GitHub
parent da1043185a
commit 924920e6e8
21 changed files with 706 additions and 2 deletions

View File

@ -0,0 +1,32 @@
<?php
namespace App\Actions\NodeJS;
use App\Enums\ServiceStatus;
use App\Models\Server;
use App\SSH\Services\NodeJS\NodeJS;
use Illuminate\Validation\ValidationException;
class ChangeDefaultCli
{
public function change(Server $server, array $input): void
{
$this->validate($server, $input);
$service = $server->nodejs($input['version']);
/** @var NodeJS $handler */
$handler = $service->handler();
$handler->setDefaultCli();
$server->defaultService('nodejs')->update(['is_default' => 0]);
$service->update(['is_default' => 1]);
$service->update(['status' => ServiceStatus::READY]);
}
public function validate(Server $server, array $input): void
{
if (! isset($input['version']) || ! in_array($input['version'], $server->installedNodejsVersions())) {
throw ValidationException::withMessages(
['version' => __('This version is not installed')]
);
}
}
}

View File

@ -0,0 +1,45 @@
<?php
namespace App\Actions\NodeJS;
use App\Enums\NodeJS;
use App\Enums\ServiceStatus;
use App\Models\Server;
use App\Models\Service;
use Illuminate\Validation\Rule;
class InstallNewNodeJsVersion
{
public function install(Server $server, array $input): void
{
$nodejs = new Service([
'server_id' => $server->id,
'type' => 'nodejs',
'type_data' => [],
'name' => 'nodejs',
'version' => $input['version'],
'status' => ServiceStatus::INSTALLING,
'is_default' => false,
]);
$nodejs->save();
dispatch(function () use ($nodejs) {
$nodejs->handler()->install();
$nodejs->status = ServiceStatus::READY;
$nodejs->save();
})->catch(function () use ($nodejs) {
$nodejs->delete();
})->onConnection('ssh');
}
public static function rules(Server $server): array
{
return [
'version' => [
'required',
Rule::in(config('core.nodejs_versions')),
Rule::notIn(array_merge($server->installedNodejsVersions(), [NodeJS::NONE])),
],
];
}
}

View File

@ -0,0 +1,53 @@
<?php
namespace App\Actions\NodeJS;
use App\Enums\ServiceStatus;
use App\Models\Server;
use App\Models\Service;
use Illuminate\Support\Facades\Validator;
use Illuminate\Validation\ValidationException;
class UninstallNodeJS
{
public function uninstall(Server $server, array $input): void
{
$this->validate($server, $input);
/** @var Service $nodejs */
$nodejs = $server->nodejs($input['version']);
$nodejs->status = ServiceStatus::UNINSTALLING;
$nodejs->save();
dispatch(function () use ($nodejs) {
$nodejs->handler()->uninstall();
$nodejs->delete();
})->catch(function () use ($nodejs) {
$nodejs->status = ServiceStatus::FAILED;
$nodejs->save();
})->onConnection('ssh');
}
/**
* @throws ValidationException
*/
private function validate(Server $server, array $input): void
{
Validator::make($input, [
'version' => 'required|string',
])->validate();
if (! in_array($input['version'], $server->installedNodejsVersions())) {
throw ValidationException::withMessages(
['version' => __('This version is not installed')]
);
}
$hasSite = $server->sites()->where('nodejs_version', $input['version'])->first();
if ($hasSite) {
throw ValidationException::withMessages(
['version' => __('Cannot uninstall this version because some sites are using it!')]
);
}
}
}

32
app/Enums/NodeJS.php Normal file
View File

@ -0,0 +1,32 @@
<?php
namespace App\Enums;
use App\Traits\Enum;
final class NodeJS
{
use Enum;
const NONE = 'none';
const V4 = '4';
const V6 = '6';
const V8 = '8';
const V10 = '10';
const V12 = '12';
const V14 = '14';
const V16 = '16';
const V18 = '18';
const V20 = '20';
const V22 = '22';
}

View File

@ -318,6 +318,17 @@ public function installedPHPVersions(): array
return $versions;
}
public function installedNodejsVersions(): array
{
$versions = [];
$nodes = $this->services()->where('type', 'nodejs')->get(['version']);
foreach ($nodes as $node) {
$versions[] = $node->version;
}
return $versions;
}
public function type(): ServerType
{
$typeClass = config('core.server_types_class')[$this->type];
@ -377,6 +388,15 @@ public function php(?string $version = null): ?Service
return $this->service('php', $version);
}
public function nodejs(?string $version = null): ?Service
{
if (! $version) {
return $this->defaultService('nodejs');
}
return $this->service('nodejs', $version);
}
public function memoryDatabase(?string $version = null): ?Service
{
if (! $version) {

View File

@ -43,6 +43,8 @@
* @property ?Ssl $activeSsl
* @property string $ssh_key_name
* @property ?SourceControl $sourceControl
*
* @TODO: Add nodejs_version column
*/
class Site extends AbstractModel
{

View File

@ -35,4 +35,29 @@ public function delete(User $user, Service $service): bool
{
return ($user->isAdmin() || $service->server->project->users->contains($user)) && $service->server->isReady();
}
public function start(User $user, Service $service): bool
{
return $this->update($user, $service) && $service->unit;
}
public function stop(User $user, Service $service): bool
{
return $this->update($user, $service) && $service->unit;
}
public function restart(User $user, Service $service): bool
{
return $this->update($user, $service) && $service->unit;
}
public function disable(User $user, Service $service): bool
{
return $this->update($user, $service) && $service->unit;
}
public function enable(User $user, Service $service): bool
{
return $this->update($user, $service) && $service->unit;
}
}

View File

@ -0,0 +1,77 @@
<?php
namespace App\SSH\Services\NodeJS;
use App\SSH\HasScripts;
use App\SSH\Services\AbstractService;
use Closure;
use Illuminate\Validation\Rule;
class NodeJS extends AbstractService
{
use HasScripts;
public function creationRules(array $input): array
{
return [
'version' => [
'required',
Rule::in(config('core.nodejs_versions')),
Rule::notIn([\App\Enums\NodeJS::NONE]),
Rule::unique('services', 'version')
->where('type', 'nodejs')
->where('server_id', $this->service->server_id),
],
];
}
public function deletionRules(): array
{
return [
'service' => [
function (string $attribute, mixed $value, Closure $fail) {
$hasSite = $this->service->server->sites()
->where('nodejs_version', $this->service->version)
->exists();
if ($hasSite) {
$fail('Some sites are using this NodeJS version.');
}
},
],
];
}
public function install(): void
{
$server = $this->service->server;
$server->ssh()->exec(
$this->getScript('install-nodejs.sh', [
'version' => $this->service->version,
'user' => $server->getSshUser(),
]),
'install-nodejs-'.$this->service->version
);
$this->service->server->os()->cleanup();
}
public function uninstall(): void
{
$this->service->server->ssh()->exec(
$this->getScript('uninstall-nodejs.sh', [
'version' => $this->service->version,
]),
'uninstall-nodejs-'.$this->service->version
);
$this->service->server->os()->cleanup();
}
public function setDefaultCli(): void
{
$this->service->server->ssh()->exec(
$this->getScript('change-default-nodejs.sh', [
'version' => $this->service->version,
]),
'change-default-nodejs'
);
}
}

View File

@ -0,0 +1,13 @@
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
if ! nvm alias default __version__; then
echo 'VITO_SSH_ERROR' && exit 1
fi
if ! nvm use default; then
echo 'VITO_SSH_ERROR' && exit 1
fi
echo "Default Node.js is now:"
node -v

View File

@ -0,0 +1,68 @@
# Download NVM, if not already downloaded
if [ ! -d "$HOME/.nvm" ]; then
if ! git clone https://github.com/nvm-sh/nvm.git "$HOME/.nvm"; then
echo 'VITO_SSH_ERROR' && exit 1
fi
fi
# Checkout the latest stable version of NVM
if ! git -C "$HOME/.nvm" checkout v0.40.1; then
echo 'VITO_SSH_ERROR' && exit 1
fi
# Load NVM
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
# Define the NVM initialization script
NVM_INIT='
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
'
# List of potential configuration files
CONFIG_FILES=("$HOME/.bash_profile" "$HOME/.bash_login" "$HOME/.profile")
# Flag to track if at least one file exists
FILE_EXISTS=false
# Loop through each configuration file and check if it exists
for config_file in "${CONFIG_FILES[@]}"; do
if [ -f "$config_file" ]; then
FILE_EXISTS=true
# Check if the NVM initialization is already present
if ! grep -q 'export NVM_DIR="$HOME/.nvm"' "$config_file"; then
echo "Adding NVM initialization to $config_file"
echo "$NVM_INIT" >> "$config_file"
else
echo "NVM initialization already exists in $config_file"
fi
fi
done
# If no file exists, fallback to .profile
if [ "$FILE_EXISTS" = false ]; then
FALLBACK_FILE="$HOME/.profile"
echo "No configuration files found. Creating $FALLBACK_FILE and adding NVM initialization."
echo "$NVM_INIT" >> "$FALLBACK_FILE"
fi
echo "NVM initialization process completed."
# Install NVM if not already installed
if ! command -v nvm > /dev/null 2>&1; then
if ! bash "$HOME/.nvm/install.sh"; then
echo 'VITO_SSH_ERROR' && exit 1
fi
fi
# Install the requested Node.js version
if ! nvm install __version__; then
echo 'VITO_SSH_ERROR' && exit 1
fi
echo "Node.js version __version__ installed successfully!"
echo "Node version:" && node -v
echo "NPM version:" && npm -v
echo "NPX version:" && npx -v

View File

@ -0,0 +1,6 @@
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
if ! nvm uninstall __version__; then
echo 'VITO_SSH_ERROR' && exit 1
fi

View File

@ -0,0 +1,66 @@
<?php
namespace App\Web\Pages\Servers\NodeJS;
use App\Actions\NodeJS\InstallNewNodeJsVersion;
use App\Enums\NodeJS;
use App\Models\Service;
use App\Web\Pages\Servers\NodeJS\Widgets\NodeJSList;
use App\Web\Pages\Servers\Page;
use Filament\Actions\Action;
use Filament\Forms\Components\Select;
use Filament\Notifications\Notification;
use Filament\Support\Enums\MaxWidth;
class Index extends Page
{
protected static ?string $slug = 'servers/{server}/nodejs';
protected static ?string $title = 'NodeJS';
public function mount(): void
{
$this->authorize('viewAny', [Service::class, $this->server]);
}
public function getWidgets(): array
{
return [
[NodeJSList::class, ['server' => $this->server]],
];
}
protected function getHeaderActions(): array
{
$installedNodeVersions = $this->server->installedNodejsVersions();
return [
Action::make('install')
->authorize(fn () => auth()->user()?->can('create', [Service::class, $this->server]))
->label('Install Node')
->icon('heroicon-o-archive-box-arrow-down')
->modalWidth(MaxWidth::Large)
->form([
Select::make('version')
->options(
collect(config('core.nodejs_versions'))
->filter(fn ($version) => ! in_array($version, array_merge($installedNodeVersions, [NodeJS::NONE])))
->mapWithKeys(fn ($version) => [$version => $version])
->toArray()
)
->rules(InstallNewNodeJsVersion::rules($this->server)['version']),
])
->modalSubmitActionLabel('Install')
->action(function (array $data) {
app(InstallNewNodeJsVersion::class)->install($this->server, $data);
Notification::make()
->success()
->title('Installing Node...')
->send();
$this->dispatch('$refresh');
}),
];
}
}

View File

@ -0,0 +1,117 @@
<?php
namespace App\Web\Pages\Servers\NodeJS\Widgets;
use App\Actions\NodeJS\ChangeDefaultCli;
use App\Actions\Service\Uninstall;
use App\Models\Server;
use App\Models\Service;
use Exception;
use Filament\Notifications\Notification;
use Filament\Tables\Actions\Action;
use Filament\Tables\Actions\ActionGroup;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Table;
use Filament\Widgets\TableWidget as Widget;
use Illuminate\Database\Eloquent\Builder;
class NodeJSList extends Widget
{
public Server $server;
protected $listeners = ['$refresh'];
protected function getTableQuery(): Builder
{
return Service::query()->where('type', 'nodejs')->where('server_id', $this->server->id);
}
protected function getTableColumns(): array
{
return [
TextColumn::make('version')
->sortable(),
TextColumn::make('status')
->label('Status')
->badge()
->color(fn (Service $service) => Service::$statusColors[$service->status])
->sortable(),
TextColumn::make('is_default')
->label('Default Cli')
->badge()
->color(fn (Service $service) => $service->is_default ? 'primary' : 'gray')
->state(fn (Service $service) => $service->is_default ? 'Yes' : 'No')
->sortable(),
TextColumn::make('created_at')
->label('Installed At')
->formatStateUsing(fn ($record) => $record->created_at_by_timezone),
];
}
/**
* @throws Exception
*/
public function table(Table $table): Table
{
return $table
->heading(null)
->query($this->getTableQuery())
->columns($this->getTableColumns())
->actions([
ActionGroup::make([
$this->defaultNodeJsCliAction(),
$this->uninstallAction(),
]),
]);
}
private function defaultNodeJsCliAction(): Action
{
return Action::make('default-nodejs-cli')
->authorize(fn (Service $nodejs) => auth()->user()?->can('update', $nodejs))
->label('Make Default CLI')
->hidden(fn (Service $service) => $service->is_default)
->action(function (Service $service) {
try {
app(ChangeDefaultCli::class)->change($this->server, ['version' => $service->version]);
Notification::make()
->success()
->title('Default NodeJS CLI changed!')
->send();
} catch (Exception $e) {
Notification::make()
->danger()
->title($e->getMessage())
->send();
throw $e;
}
$this->dispatch('$refresh');
});
}
private function uninstallAction(): Action
{
return Action::make('uninstall')
->authorize(fn (Service $nodejs) => auth()->user()?->can('update', $nodejs))
->label('Uninstall')
->color('danger')
->requiresConfirmation()
->action(function (Service $service) {
try {
app(Uninstall::class)->uninstall($service);
} catch (Exception $e) {
Notification::make()
->danger()
->title($e->getMessage())
->send();
throw $e;
}
$this->dispatch('$refresh');
});
}
}

View File

@ -18,6 +18,7 @@
use App\Web\Pages\Servers\Firewall\Index as FirewallIndex;
use App\Web\Pages\Servers\Logs\Index as LogsIndex;
use App\Web\Pages\Servers\Metrics\Index as MetricsIndex;
use App\Web\Pages\Servers\NodeJS\Index as NodeJsIndex;
use App\Web\Pages\Servers\PHP\Index as PHPIndex;
use App\Web\Pages\Servers\Services\Index as ServicesIndex;
use App\Web\Pages\Servers\Settings as ServerSettings;
@ -60,11 +61,18 @@ public function getSubNavigation(): array
if (auth()->user()->can('viewAny', [Service::class, $this->server])) {
$items[] = NavigationItem::make(PHPIndex::getNavigationLabel())
->icon('heroicon-o-code-bracket')
->icon('icon-php-alt')
->isActiveWhen(fn () => request()->routeIs(PHPIndex::getRouteName().'*'))
->url(PHPIndex::getUrl(parameters: ['server' => $this->server]));
}
if (auth()->user()->can('viewAny', [Service::class, $this->server])) {
$items[] = NavigationItem::make(NodeJsIndex::getNavigationLabel())
->icon('icon-nodejs-alt')
->isActiveWhen(fn () => request()->routeIs(NodeJsIndex::getRouteName().'*'))
->url(NodeJsIndex::getUrl(parameters: ['server' => $this->server]));
}
if (auth()->user()->can('viewAny', [FirewallRule::class, $this->server])) {
$items[] = NavigationItem::make(FirewallIndex::getNavigationLabel())
->icon('heroicon-o-fire')

View File

@ -75,7 +75,7 @@ public function table(Table $table): Table
private function serviceAction(string $type, string $icon): Action
{
return Action::make($type)
->authorize(fn (Service $service) => auth()->user()?->can('update', $service))
->authorize(fn (Service $service) => auth()->user()?->can($type, $service))
->label(ucfirst($type).' Service')
->icon($icon)
->action(function (Service $service) use ($type) {