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.
233 lines
10 KiB
PHP
233 lines
10 KiB
PHP
<?php
|
|
|
|
namespace App\Controllers;
|
|
|
|
use App\Services\Cloud\CloudAccess;
|
|
use App\Services\Cloud\CloudAdminInstanceService;
|
|
use App\Services\Cloud\CloudError;
|
|
use App\Services\Cloud\CloudInput;
|
|
use App\Services\Cloud\CloudJobService;
|
|
use App\Services\Cloud\CloudNetworkChangeOptionsService;
|
|
use App\Services\Cloud\CloudSecrets;
|
|
use App\Services\Cloud\CloudSSHKeys;
|
|
|
|
/** Administrator projections plus explicitly queued VM mutations. */
|
|
final class CloudAdminInstanceController
|
|
{
|
|
public function index($request, $response)
|
|
{
|
|
return $response->withJson(CloudAdminInstanceService::page(
|
|
$request->getAttribute('cloud_actor') ?? CloudAccess::actor(false),
|
|
$request->getQueryParams()
|
|
))->withHeader('Cache-Control', 'private, no-store');
|
|
}
|
|
|
|
public function detail($request, $response, $args)
|
|
{
|
|
return $response->withJson(CloudAdminInstanceService::detail(
|
|
$request->getAttribute('cloud_actor') ?? CloudAccess::actor(false),
|
|
(string) ($args['id'] ?? '')
|
|
))->withHeader('Cache-Control', 'private, no-store');
|
|
}
|
|
|
|
/**
|
|
* Return current host network choices from the configured PHP ledger.
|
|
*
|
|
* The host Agent remains the final exact-IP claim authority when the job is
|
|
* executed; this read path deliberately does not perform a host capacity
|
|
* scan or require a host freshness marker.
|
|
*/
|
|
public function networkOptions($request, $response, $args)
|
|
{
|
|
$actor = $request->getAttribute('cloud_actor')
|
|
?? CloudAccess::actor(false);
|
|
CloudAccess::manage($actor);
|
|
$instance = CloudAccess::instance(
|
|
(string) ($args['id'] ?? ''),
|
|
$actor
|
|
);
|
|
return $response->withJson(
|
|
CloudNetworkChangeOptionsService::forInstance($instance)
|
|
)->withHeader('Cache-Control', 'private, no-store');
|
|
}
|
|
|
|
/**
|
|
* Queue a controlled same-host public IPv4 replacement.
|
|
*
|
|
* PHP/IPAM owns the pool and claim swap. The Agent applies the signed
|
|
* network intent on the selected host. PHP updates spec_json only after
|
|
* the durable Agent operation confirms success.
|
|
*/
|
|
public function network($request, $response, $args)
|
|
{
|
|
$actor = $request->getAttribute('cloud_actor') ?? CloudAccess::actor(false);
|
|
CloudAccess::manage($actor);
|
|
$instance = CloudAccess::instance((string) ($args['id'] ?? ''), $actor, true);
|
|
if ((string) $instance->status !== 'active') {
|
|
throw new CloudError('只有处于活动状态的虚拟机可以更换公网 IP', 409);
|
|
}
|
|
$body = CloudInput::object($request);
|
|
CloudInput::only($body,
|
|
['public_ip_cidr', 'public_pool_key', 'confirm_restart']);
|
|
if (($body['confirm_restart'] ?? false) !== true) {
|
|
throw new CloudError('更换公网 IP 前必须确认虚拟机会短暂重启');
|
|
}
|
|
$cidr = CloudInput::publicIpCidr($body['public_ip_cidr'] ?? null);
|
|
$publicPoolKey = CloudInput::publicPoolKey(
|
|
$body['public_pool_key'] ?? null
|
|
);
|
|
$spec = json_decode((string) $instance->spec_json, true);
|
|
if (!is_array($spec) || array_is_list($spec)
|
|
|| ($spec['managed'] ?? false) !== true
|
|
|| ($spec['os_source'] ?? null) !== 'cloud_template') {
|
|
throw new CloudError('当前虚拟机不是支持网络配置的面板云镜像实例', 409);
|
|
}
|
|
$current = is_string($spec['public_ip_cidr'] ?? null)
|
|
? trim($spec['public_ip_cidr']) : '';
|
|
if ($current !== '' && $current === $cidr) {
|
|
throw new CloudError('新公网 IP 与当前配置相同', 409);
|
|
}
|
|
$job = CloudJobService::enqueue($instance, $actor, 'network_change', 'POST',
|
|
'/network', [
|
|
'public_ip_cidr' => $cidr,
|
|
'public_pool_key' => $publicPoolKey,
|
|
'confirm_restart' => true,
|
|
]);
|
|
return $response->withJson([
|
|
'task_id' => (string) $job->id,
|
|
'status_url' => '/api/v1/tasks/' . $job->id,
|
|
], 202)->withHeader('Cache-Control', 'no-store');
|
|
}
|
|
|
|
/**
|
|
* Queue a controlled guest-settings update for a panel-managed instance.
|
|
*
|
|
* The public-key field is intentionally parsed from this request only;
|
|
* unlike the tenant reinstall flow it never accepts an SSH-key id and
|
|
* never reads the owner's saved key collection. Password material stays
|
|
* in the encrypted job/credential path and is not returned to the browser.
|
|
*/
|
|
public function settings($request, $response, $args)
|
|
{
|
|
$actor = $request->getAttribute('cloud_actor') ?? CloudAccess::actor(false);
|
|
CloudAccess::manage($actor);
|
|
$instance = CloudAccess::instance((string) ($args['id'] ?? ''), $actor, true);
|
|
if ((string) $instance->status !== 'active') {
|
|
throw new CloudError('只有处于活动状态的虚拟机可以修改实例设置', 409);
|
|
}
|
|
$body = CloudInput::object($request);
|
|
CloudInput::only($body, ['hostname', 'root_password', 'ssh_public_key', 'confirm_restart']);
|
|
if (($body['confirm_restart'] ?? false) !== true) {
|
|
throw new CloudError('修改实例设置前必须确认虚拟机会短暂重启');
|
|
}
|
|
|
|
$spec = json_decode((string) $instance->spec_json, true);
|
|
if (!is_array($spec) || array_is_list($spec)
|
|
|| ($spec['managed'] ?? false) !== true
|
|
|| ($spec['os_source'] ?? null) !== 'cloud_template'
|
|
|| (!is_string($spec['public_ip_cidr'] ?? null)
|
|
&& !is_string($spec['public_ip'] ?? null))) {
|
|
throw new CloudError('当前虚拟机不是支持实例设置的面板云镜像实例', 409);
|
|
}
|
|
|
|
$agentBody = ['confirm_restart' => true];
|
|
$existingCredential = self::credentialSnapshot($instance);
|
|
$credential = null;
|
|
$changed = false;
|
|
if (array_key_exists('hostname', $body)) {
|
|
if (!is_string($body['hostname']) || trim($body['hostname']) === '') {
|
|
throw new CloudError('主机名不能为空');
|
|
}
|
|
$agentBody['hostname'] = CloudInput::hostname($body['hostname']);
|
|
$changed = true;
|
|
}
|
|
if (array_key_exists('root_password', $body)) {
|
|
if (!is_string($body['root_password']) || $body['root_password'] === '') {
|
|
throw new CloudError('实例密码不能为空');
|
|
}
|
|
$password = CloudInput::password($body['root_password']);
|
|
$agentBody['root_password'] = $password;
|
|
$credential = ['password' => $password, 'login_name' => 'root',
|
|
'auth_mode' => 'password'];
|
|
$changed = true;
|
|
}
|
|
if (array_key_exists('ssh_public_key', $body)) {
|
|
if (!is_string($body['ssh_public_key']) || trim($body['ssh_public_key']) === '') {
|
|
throw new CloudError('SSH 公钥不能为空');
|
|
}
|
|
// Direct input only. Do not call CloudSSHKeys::owned() here.
|
|
$parsed = CloudSSHKeys::parse($body['ssh_public_key']);
|
|
$agentBody['ssh_public_key'] = $parsed['public_key'];
|
|
$changed = true;
|
|
}
|
|
if (!$changed) {
|
|
throw new CloudError('请至少填写一项需要修改的实例设置');
|
|
}
|
|
|
|
// Keep PHP's reveal metadata aligned with the guest seed. A key-only
|
|
// change preserves an existing password marker, while a password-only
|
|
// change preserves the fact that the old key remains in the guest.
|
|
// The public key itself is deliberately not copied into this record.
|
|
if (array_key_exists('root_password', $agentBody)
|
|
|| array_key_exists('ssh_public_key', $agentBody)) {
|
|
$previousMode = (string) ($existingCredential['auth_mode'] ?? '');
|
|
$previousPassword = $existingCredential['password'] ?? null;
|
|
$savedPassword = array_key_exists('root_password', $agentBody)
|
|
? $agentBody['root_password'] : $previousPassword;
|
|
$hasPassword = is_string($savedPassword) && $savedPassword !== '';
|
|
$hasKey = array_key_exists('ssh_public_key', $agentBody)
|
|
|| in_array($previousMode,
|
|
['password_and_key', 'ssh_key', 'ssh_key_password'], true);
|
|
$credential = [
|
|
'password' => $hasPassword ? $savedPassword : null,
|
|
'login_name' => 'root',
|
|
'auth_mode' => $hasPassword
|
|
? ($hasKey ? 'password_and_key' : 'password') : 'ssh_key',
|
|
];
|
|
}
|
|
|
|
$job = CloudJobService::enqueue($instance, $actor, 'instance_settings', 'POST',
|
|
'/settings', $agentBody, $credential);
|
|
return $response->withJson([
|
|
'task_id' => (string) $job->id,
|
|
'status_url' => '/api/v1/tasks/' . $job->id,
|
|
], 202)->withHeader('Cache-Control', 'no-store');
|
|
}
|
|
|
|
/**
|
|
* Read only the existing non-key credential metadata needed to preserve
|
|
* login-mode state across an administrator settings update. A malformed
|
|
* encrypted record must not be silently replaced with an incomplete DTO.
|
|
*/
|
|
private static function credentialSnapshot($instance): ?array
|
|
{
|
|
if ($instance->sealed_credential === null) {
|
|
return null;
|
|
}
|
|
try {
|
|
$value = CloudSecrets::decrypt(
|
|
(string) $instance->sealed_credential,
|
|
'instance-credential'
|
|
);
|
|
} catch (\Throwable $exception) {
|
|
throw new CloudError('实例凭据记录异常,暂不能修改实例设置', 503);
|
|
}
|
|
if (!is_array($value)
|
|
|| !in_array($value['auth_mode'] ?? null,
|
|
['password', 'password_and_key', 'ssh_key', 'ssh_key_password'], true)
|
|
|| (($value['password'] ?? null) !== null
|
|
&& !is_string($value['password']))
|
|
|| (in_array($value['auth_mode'],
|
|
['password', 'password_and_key', 'ssh_key_password'], true)
|
|
&& (!is_string($value['password'] ?? null)
|
|
|| $value['password'] === ''))
|
|
|| ($value['auth_mode'] === 'ssh_key'
|
|
&& ($value['password'] ?? null) !== null)) {
|
|
throw new CloudError('实例凭据记录异常,暂不能修改实例设置', 503);
|
|
}
|
|
return ['auth_mode' => (string) $value['auth_mode'],
|
|
'password' => $value['password'] ?? null];
|
|
}
|
|
|
|
}
|