You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
virt/web/app/Controllers/CloudAdminController.php

270 lines
12 KiB
PHP

<?php
namespace App\Controllers;
use App\Models\CloudHost;
use App\Services\Cloud\CloudAccess;
use App\Services\Cloud\CloudDeploymentPageService;
use App\Services\Cloud\CloudEngineClient;
use App\Services\Cloud\CloudError;
use App\Services\Cloud\CloudInput;
use App\Services\Cloud\CloudInstanceDiscovery;
use App\Services\Cloud\CloudUserIsoFeature;
final class CloudAdminController
{
private const HOST_COUNTRY_CODES = ['CN', 'JP', 'US', 'SG'];
private function actor($request, bool $write = false): array
{
$actor = $request->getAttribute('cloud_actor') ?? CloudAccess::actor();
if (!$actor['is_admin']) {
throw new CloudError('需要管理员权限', 403);
}
if ($write) {
CloudAccess::manage($actor);
}
return $actor;
}
private function host($id): CloudHost
{
$host = CloudHost::find($id);
if ($host === null) {
throw new CloudError('宿主机不存在', 404);
}
return $host;
}
public function scan($request, $response)
{
$actor = $this->actor($request, true);
$body = CloudInput::object($request);
CloudInput::only($body, ['host', 'port']);
return $response->withJson((new CloudEngineClient())->request('POST', '/internal/v1/hosts/scan', $actor, $body));
}
public function hosts($request, $response, $args = [])
{
$write = $request->getMethod() !== 'GET';
$actor = $this->actor($request, $write);
$engine = new CloudEngineClient();
if (!$write && !isset($args['id'])) {
return $response->withJson(['hosts' => CloudHost::orderBy('id')->get()->toArray()]);
}
if (!$write) {
$host = $this->host($args['id']);
return $response->withJson(array_merge($host->toArray(), $engine->host((int) $host->id, 'GET', 'host', $actor)));
}
$body = CloudInput::object($request, 131072);
CloudInput::only($body, ['name', 'enabled', 'host', 'port', 'private_key', 'private_key_passphrase', 'host_key',
'confirmed_fingerprint', 'storage_pool', 'iso_pool', 'rescue_iso_pool', 'default_network', 'region', 'country_code',
'public_pool_cidr', 'public_gateway', 'public_dns_servers', 'public_reserved_ips', 'public_vm_prefix']);
$name = $body['name'] ?? '';
if (!is_string($name) || trim($name) === '' || mb_strlen($name) > 80) {
throw new CloudError('宿主机名称需为 1 至 80 字符');
}
$enabled = filter_var($body['enabled'] ?? true, FILTER_VALIDATE_BOOLEAN, FILTER_NULL_ON_FAILURE);
if ($enabled === null) {
throw new CloudError('启用状态无效');
}
$region = $body['region'] ?? '';
if (!is_string($region) || trim($region) === '' || mb_strlen(trim($region)) > 64) {
throw new CloudError('具体地区需为 1 至 64 字符,例如 HongKong 或 Tokyo');
}
$body['region'] = trim($region);
$countryCode = $body['country_code'] ?? null;
if (!is_string($countryCode) || !in_array($countryCode, self::HOST_COUNTRY_CODES, true)) {
throw new CloudError('国家代码无效,请选择中国、日本、美国或新加坡');
}
unset($body['name'], $body['enabled'], $body['country_code']);
$host = isset($args['id']) ? $this->host($args['id']) : new CloudHost();
if (!$host->exists) {
$host->name = trim($name);
$host->region = '';
$host->country_code = $countryCode;
$host->enabled = false;
$host->default_network = 'default';
$host->created_at = $host->updated_at = time();
$host->save();
}
// Secrets only transit this request. They are exclusively encrypted/stored by the engine.
$result = $engine->host((int) $host->id, 'PUT', 'host', $actor, $body);
$host->name = trim($name);
$host->region = (string) ($result['region'] ?? $body['region'] ?? '');
$host->country_code = $countryCode;
$host->default_network = (string) ($result['default_network'] ?? $body['default_network'] ?? 'default');
$host->enabled = $enabled;
$host->updated_at = time();
$host->save();
$warnings = is_array($result['warnings'] ?? null) ? $result['warnings'] : [];
$inventorySync = null;
try {
$inventory = $engine->host((int) $host->id, 'POST', 'host/discover-vms', $actor, [
// Casting is required for the empty case: JSON [] is a list,
// while the engine contract requires an owner map ({}) keyed
// by UUID.
'known_owners' => (object) CloudInstanceDiscovery::knownOwners((int) $host->id),
// Saving a host is an explicit super-admin action. Import
// every VM not yet represented by either ownership database,
// including guests carrying metadata from an older panel.
'claim_unowned_managed' => true,
]);
$inventorySync = CloudInstanceDiscovery::synchronize($host, $inventory);
if ($inventorySync['ownership_conflicts'] > 0) {
$warnings[] = '发现虚拟机在业务库与引擎中的归属不一致,已保留原归属,请检查日志';
}
} catch (\Throwable $error) {
$log = 'Host VM discovery failed after host save: ' . get_class($error);
if ($error instanceof CloudError) {
$log .= ' status=' . $error->httpStatus . ' message=' . $error->getMessage();
}
error_log($log);
if ($error instanceof CloudError && $error->httpStatus === 404) {
$warnings[] = '宿主机已保存,但引擎尚未加载扫描接口;请重启 virt-cloud-engine.service 后再次保存';
} elseif ($error instanceof CloudError) {
$warnings[] = '宿主机已保存,但引擎扫描未完成;请查看 virt-cloud-engine.service 日志后重试';
} else {
$warnings[] = '宿主机已保存,但业务库导入失败;请执行 php xcat cloudInit 后再次保存';
}
}
return $response->withJson(array_merge($result, $host->toArray(), [
'warnings' => array_values(array_filter($warnings)),
'inventory_sync' => $inventorySync,
]), isset($args['id']) ? 200 : 201);
}
public function test($request, $response, $args)
{
$actor = $this->actor($request, true);
$this->host($args['id']);
$body = CloudInput::object($request, 131072);
return $response->withJson((new CloudEngineClient())->host((int) $args['id'], 'POST', 'host/test', $actor, $body));
}
public function userIsoSettings($request, $response)
{
$write = $request->getMethod() !== 'GET';
$this->actor($request, $write);
if (!$write) {
return $response->withJson(['enabled' => CloudUserIsoFeature::enabled()]);
}
$body = CloudInput::object($request);
CloudInput::only($body, ['enabled']);
$enabled = filter_var($body['enabled'] ?? null, FILTER_VALIDATE_BOOLEAN,
FILTER_NULL_ON_FAILURE);
if ($enabled === null) {
throw new CloudError('用户 ISO 开关状态无效');
}
CloudUserIsoFeature::save($enabled);
return $response->withJson(['enabled' => $enabled]);
}
public function templates($request, $response, $args = [])
{
$method = $request->getMethod();
$actor = $this->actor($request, $method !== 'GET');
$body = in_array($method, ['POST', 'PATCH', 'PUT'], true) ? CloudInput::object($request) : null;
$kind = $args['kind'];
if ($kind === 'cloud') {
if ($body !== null) {
unset($body['host_id']);
if ($method === 'POST' && isset($body['sha256'])
&& is_string($body['sha256']) && trim($body['sha256']) === '') {
unset($body['sha256']);
}
}
$path = '/internal/v1/vm-templates';
if (isset($args['id'])) {
$path .= '/' . rawurlencode($args['id']);
} elseif ($method === 'POST') {
$path .= '/import';
}
if (isset($args['job_id'])) {
$path .= '/import-jobs/' . rawurlencode($args['job_id']);
}
$result = (new CloudEngineClient())->request($method, $path, $actor, $body);
if ($method === 'GET' && !isset($args['job_id']) && !isset($args['id'])) {
CloudDeploymentPageService::rememberTemplateCatalog($result);
} elseif (is_array($result['template'] ?? null)) {
CloudDeploymentPageService::rememberTemplate($result['template']);
}
return $response->withJson($result);
}
// Rescue ISOs remain deliberately scoped to one host and its separate
// rescue directory.
$query = $request->getQueryParams();
$hostId = filter_var($query['host_id'] ?? $body['host_id'] ?? null,
FILTER_VALIDATE_INT);
if (!$hostId) {
throw new CloudError('请选择宿主机');
}
$this->host($hostId);
if ($body !== null) {
unset($body['host_id']);
}
$resource = 'rescue-templates';
if (isset($args['id'])) {
$resource .= '/' . rawurlencode($args['id']);
}
if (isset($args['job_id'])) {
$resource .= '/import-jobs/' . rawurlencode($args['job_id']);
}
return $response->withJson((new CloudEngineClient())->host($hostId, $method, $resource, $actor, $body));
}
public function rescueUpload($request, $response)
{
$actor = $this->actor($request, true);
$query = $request->getQueryParams();
$hostId = filter_var($query['host_id'] ?? null, FILTER_VALIDATE_INT);
$name = $query['name'] ?? '';
if (!$hostId || !is_string($name) || trim($name) === '' || mb_strlen($name) > 64) {
throw new CloudError('请选择宿主机并填写救援模板名称');
}
$this->host($hostId);
if (strtolower(trim(explode(';', $request->getHeaderLine('Content-Type'))[0])) !== 'application/octet-stream') {
throw new CloudError('请直接上传 ISO 文件内容');
}
$temporary = tempnam(sys_get_temp_dir(), 'cloud-rescue-');
if ($temporary === false) {
throw new CloudError('无法准备私有上传文件', 503);
}
chmod($temporary, 0600);
$file = fopen($temporary, 'wb');
try {
if ($file === false) {
throw new CloudError('无法准备私有上传文件', 503);
}
$bytes = 0;
$stream = $request->getBody();
while (!$stream->eof()) {
$chunk = $stream->read(1048576);
$bytes += strlen($chunk);
if ($bytes > 8 * 1024 * 1024 * 1024) {
throw new CloudError('救援 ISO 超过 8 GiB', 413);
}
if ($chunk === '' && !$stream->eof()) {
throw new CloudError('上传中断');
}
if (fwrite($file, $chunk) !== strlen($chunk)) {
throw new CloudError('无法保存上传文件', 503);
}
}
fclose($file);
$file = null;
if ($bytes < 32768) {
throw new CloudError('ISO 文件内容无效');
}
return $response->withJson((new CloudEngineClient())->upload('/internal/v1/hosts/' . $hostId
. '/rescue-templates?name=' . rawurlencode(trim($name)), $actor, $temporary), 202);
} finally {
if (is_resource($file)) {
fclose($file);
}
unlink($temporary);
}
}
}