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/tests/CloudVpcEngineErrorContract...

312 lines
13 KiB
PHP

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

<?php
namespace App\Services {
final class Config
{
public static function get($name, $default = null)
{
return $name === 'cloud_engine_url' ? 'http://127.0.0.1:8000' : $default;
}
}
}
namespace App\Services\Cloud {
final class CloudSecrets
{
public static function key(string $purpose): string
{
return str_repeat('k', 32);
}
}
}
namespace GuzzleHttp {
final class VpcErrorTestResponse
{
public function __construct(private int $status, private string $body)
{
}
public function getStatusCode(): int
{
return $this->status;
}
public function getBody(): string
{
return $this->body;
}
}
class Client
{
public function __construct(private array $responses = [])
{
}
public function request(string $method, string $url, array $options): VpcErrorTestResponse
{
$response = array_shift($this->responses);
if (!$response instanceof VpcErrorTestResponse) {
throw new \RuntimeException('No fake engine response was queued.');
}
return $response;
}
}
}
namespace {
use App\Services\Cloud\CloudEngineClient;
use App\Services\Cloud\CloudError;
use GuzzleHttp\Client;
use GuzzleHttp\VpcErrorTestResponse;
require dirname(__DIR__) . '/app/Services/Cloud/CloudError.php';
require dirname(__DIR__) . '/app/Services/Cloud/CloudEngineClient.php';
$assert = static function ($condition, string $message): void {
if (!$condition) {
throw new RuntimeException($message);
}
};
$actor = ['user_id' => 1, 'is_admin' => false, 'can_manage' => false];
$deletePath = '/internal/v1/vpcs/' . str_repeat('a', 32) . '/delete';
$safeMessage = 'VPC 宿主机清理尚未全部确认,请稍后重新核对';
$request = static function (string $path, int $status, string $errorCode,
string $method = 'POST') use ($actor): CloudError {
$client = new CloudEngineClient(new Client([
new VpcErrorTestResponse($status, json_encode([
'error_code' => $errorCode,
'error' => 'Traceback: host=/root/private key=secret',
], JSON_UNESCAPED_UNICODE)),
]));
try {
$client->request($method, $path, $actor, []);
} catch (CloudError $error) {
return $error;
}
throw new RuntimeException('The fake VPC engine failure did not raise CloudError.');
};
$coordinationOperation = str_repeat('b', 32);
$vpcApplyRequest = static function (string $method, string $path, int $status,
string $code, ?string $expectedOperation, array $extra = []) use ($actor): CloudError {
$client = new CloudEngineClient(new Client([
new VpcErrorTestResponse($status, json_encode(array_replace([
'error_code' => $code,
'error' => 'Traceback: host=/root/private key=secret',
], $extra), JSON_THROW_ON_ERROR)),
]));
try {
$client->request($method, $path, $actor, [], $expectedOperation);
} catch (CloudError $error) {
return $error;
}
throw new RuntimeException('The fake VPC apply coordination failure did not raise CloudError.');
};
$reviewed = $request($deletePath, 503, 'vpc_delete_incomplete');
$assert($reviewed->getMessage() === $safeMessage
&& $reviewed->httpStatus === 503
&& $reviewed->errorCode === 'vpc_delete_incomplete'
&& !str_contains($reviewed->getMessage(), '/root')
&& !str_contains($reviewed->getMessage(), 'private'),
'The reviewed delete-incomplete response lost its fixed message or machine code.');
foreach (['/internal/v1/vpcs/apply', $deletePath] as $path) {
$stopped = $request($path, 409, 'vpc_private_remove_requires_stopped');
$assert($stopped->httpStatus === 409
&& $stopped->errorCode === 'vpc_private_remove_requires_stopped'
&& str_contains($stopped->getMessage(), '先关机')
&& !str_contains($stopped->getMessage(), '/root'),
'A reviewed stopped prerequisite lost its durable code or exposed upstream details.');
}
foreach ([
[409, 'coordination_busy', 'VPC 应用协调资源正被占用,请管理员核对协调占用'],
[503, 'coordination_uncertain', 'VPC 应用协调结果未确认,请管理员核对协调记录'],
[503, 'coordination_unavailable', 'VPC 应用协调数据库暂不可用,请管理员核对数据库状态'],
] as [$status, $code, $message]) {
$error = $vpcApplyRequest('POST', '/internal/v1/vpcs/apply', $status,
$code, $coordinationOperation);
$assert($error->httpStatus === $status && $error->errorCode === $code
&& $error->getMessage() === $message
&& !str_contains($error->getMessage(), '/root')
&& !str_contains($error->getMessage(), 'private'),
'A reviewed VPC apply coordination failure lost its exact contract.');
}
foreach ([
['GET', '/internal/v1/vpcs/apply', 409, 'coordination_busy', $coordinationOperation],
['PUT', '/internal/v1/vpcs/apply', 503, 'coordination_uncertain', $coordinationOperation],
['POST', '/internal/v1/vpcs/apply?retry=true', 409, 'coordination_busy', $coordinationOperation],
['POST', '/internal/v1/vpcs/' . str_repeat('a', 32) . '/reconcile', 503,
'coordination_uncertain', $coordinationOperation],
['POST', '/internal/v1/vpcs/apply', 503, 'coordination_busy', $coordinationOperation],
['POST', '/internal/v1/vpcs/apply', 409, 'coordination_uncertain', $coordinationOperation],
['POST', '/internal/v1/vpcs/apply', 409, 'coordination_unavailable', $coordinationOperation],
['POST', '/internal/v1/vpcs/apply', 500, 'coordination_unavailable', $coordinationOperation],
['POST', '/internal/v1/vpcs/apply', 409, 'coordination_busy', null],
['POST', '/internal/v1/vpcs/apply', 503, 'coordination_uncertain', 'invalid'],
] as [$method, $path, $status, $code, $expectedOperation]) {
$error = $vpcApplyRequest($method, $path, $status, $code, $expectedOperation);
$assert($error->httpStatus === 502 && $error->errorCode === null
&& $error->getMessage() === '虚拟化操作未成功(引擎状态 ' . $status . ')',
'A wrong VPC apply endpoint, status or operation identity crossed the coordination boundary.');
}
foreach ([
['operation_id' => $coordinationOperation],
['status' => 'uncertain'],
['safe_to_refund' => false],
['result' => ['state' => 'unknown']],
['mutation_started' => true],
['execution_outcome' => 'unknown'],
] as $extra) {
$error = $vpcApplyRequest('POST', '/internal/v1/vpcs/apply', 503,
'coordination_uncertain', $coordinationOperation, $extra);
$assert($error->httpStatus === 502 && $error->errorCode === null,
'An operation outcome field was mistaken for a bare VPC coordination failure.');
}
$durableVpcOutcome = [
'operation_id' => $coordinationOperation,
'status' => 'uncertain',
'safe_to_refund' => false,
'mutation_started' => true,
'execution_outcome' => 'unknown',
'error_code' => 'coordination_uncertain',
];
$durableVpcClient = new CloudEngineClient(new Client([
new VpcErrorTestResponse(503, json_encode($durableVpcOutcome, JSON_THROW_ON_ERROR)),
]));
$assert($durableVpcClient->request('POST', '/internal/v1/vpcs/apply', $actor, [],
$coordinationOperation) === $durableVpcOutcome + ['_engine_http_status' => 503],
'A durable VPC operation outcome was mistaken for a bare coordination response.');
foreach ([
[$deletePath, 503, 'vpc_unknown_failure'],
['/internal/v1/vpcs/apply', 503, 'vpc_delete_incomplete'],
['/internal/v1/vpcs/' . str_repeat('a', 32) . '/reconcile', 503,
'vpc_delete_incomplete'],
['/internal/v1/vpcs/' . str_repeat('a', 32), 503,
'vpc_delete_incomplete'],
[$deletePath . '?unexpected=true', 503, 'vpc_delete_incomplete'],
[$deletePath, 500, 'vpc_delete_incomplete'],
[$deletePath, 502, 'vpc_delete_incomplete'],
] as [$path, $status, $errorCode]) {
$generic = $request($path, $status, $errorCode);
$assert($generic->getMessage() === '虚拟化操作未成功(引擎状态 ' . $status . ')'
&& $generic->httpStatus === 502
&& $generic->errorCode === null
&& !str_contains($generic->getMessage(), '/root')
&& !str_contains($generic->getMessage(), 'private'),
'A non-allowlisted VPC server error crossed the generic trust boundary.');
}
foreach (['GET', 'PUT'] as $method) {
$generic = $request(
$deletePath, 503, 'vpc_delete_incomplete', $method
);
$assert($generic->getMessage() === '虚拟化操作未成功(引擎状态 503)'
&& $generic->httpStatus === 502
&& $generic->errorCode === null,
'A non-POST VPC delete error crossed the typed 503 trust boundary.');
}
$powerOperation = str_repeat('c', 32);
$powerPath = '/internal/v1/hosts/2/vms/cbd12dbc-2526-4300-96a5-774a0d431056/actions';
$operationPath = '/internal/v1/operations/' . $powerOperation;
$powerRequest = static function (string $method, string $path, int $status,
string $code, ?string $expectedOperation, array $extra = []) use ($actor): CloudError {
$client = new CloudEngineClient(new Client([
new VpcErrorTestResponse($status, json_encode(array_replace([
'error_code' => $code,
'error' => 'Traceback: host=/root/private key=secret',
], $extra), JSON_THROW_ON_ERROR)),
]));
try {
$client->request($method, $path, $actor,
$method === 'POST' ? ['action' => 'shutdown'] : null, $expectedOperation);
} catch (CloudError $error) {
return $error;
}
throw new RuntimeException('The fake power admission failure did not raise CloudError.');
};
foreach ([['POST', $powerPath], ['GET', $operationPath]] as [$method, $path]) {
$busy = $powerRequest($method, $path, 409, 'coordination_busy', $powerOperation);
$assert($busy->httpStatus === 409 && $busy->errorCode === 'coordination_busy'
&& $busy->getMessage() === '实例操作正在排队,请稍后核对'
&& !str_contains($busy->getMessage(), '/root'),
'A known power admission conflict lost its retryable status or exposed upstream details.');
}
foreach ([
['POST', $powerPath, 503, 'coordination_busy', $powerOperation],
['POST', $powerPath, 409, 'coordination_uncertain', $powerOperation],
['POST', $powerPath, 503, 'coordination_uncertain', $powerOperation],
['POST', $powerPath, 409, 'coordination_unavailable', $powerOperation],
['POST', $powerPath, 403, 'coordination_busy', $powerOperation],
['POST', $powerPath, 409, 'coordination_busy', null],
['POST', $powerPath, 409, 'coordination_busy', 'invalid'],
['POST', $powerPath . '?unexpected=true', 409, 'coordination_busy', $powerOperation],
['PUT', $powerPath, 409, 'coordination_busy', $powerOperation],
['GET', $powerPath, 409, 'coordination_busy', $powerOperation],
['POST', str_replace('/actions', '/network', $powerPath), 409, 'coordination_busy', $powerOperation],
['POST', $operationPath, 409, 'coordination_busy', $powerOperation],
['GET', $operationPath . '?reconcile=false', 409, 'coordination_busy', $powerOperation],
['GET', $operationPath, 409, 'coordination_busy', str_repeat('d', 32)],
['GET', $operationPath, 409, 'coordination_busy', null],
] as [$method, $path, $status, $code, $expectedOperation]) {
$error = $powerRequest($method, $path, $status, $code, $expectedOperation);
$assert($error->httpStatus === 502 && $error->errorCode === null,
'An unreviewed failure became a retryable power admission conflict.');
}
foreach ([
['operation_id' => $powerOperation],
['status' => 'uncertain'],
['result' => ['command_accepted' => true]],
['mutation_started' => true],
['execution_outcome' => 'unknown'],
] as $extra) {
$error = $powerRequest('POST', $powerPath, 409, 'coordination_busy', $powerOperation, $extra);
$assert($error->httpStatus === 502 && $error->errorCode === null,
'An operation outcome was mistaken for a bare admission rejection.');
}
foreach (['failed', 'uncertain'] as $status) {
$outcome = [
'operation_id' => $powerOperation, 'status' => $status,
'safe_to_refund' => false, 'mutation_started' => true,
'execution_outcome' => 'unknown', 'error_code' => 'coordination_busy',
];
$client = new CloudEngineClient(new Client([
new VpcErrorTestResponse(409, json_encode($outcome, JSON_THROW_ON_ERROR)),
]));
$receipt = $client->request('POST', $powerPath, $actor,
['action' => 'shutdown'], $powerOperation);
$assert($receipt === $outcome + ['_engine_http_status' => 409],
'The durable operation outcome lost priority over the admission error policy.');
}
foreach ([
new Client([]),
new Client([new VpcErrorTestResponse(502, '<html>bad gateway</html>')]),
] as $transportClient) {
try {
(new CloudEngineClient($transportClient))->request(
'POST', $powerPath, $actor, ['action' => 'shutdown'], $powerOperation
);
throw new RuntimeException('The fake transport failure did not raise CloudError.');
} catch (CloudError $error) {
$assert($error->httpStatus === 502
&& $error->errorCode === 'engine_transport_uncertain'
&& !str_contains($error->getMessage(), '/root'),
'A local transport failure lost its safe fixed-ID recovery marker.');
}
}
echo "Cloud VPC engine error-code contract passed.\n";
}