import hashlib import json import tempfile import unittest from pathlib import Path from unittest.mock import Mock, patch import production_cd as cd import hifox_release_trigger as trigger SHA = 'a' * 40 TASK = 'd5abdf29-d0b5-4992-8073-0cb8fffd84ed' IMAGES = {role: 'sha256:' + str(i) * 64 for i, role in enumerate(('api', 'web', 'worker'), 1)} CTX = 'build / build (push)' class ProductionCD(unittest.TestCase): def setUp(self): temp = tempfile.TemporaryDirectory() self.addCleanup(temp.cleanup) self.root = Path(temp.name) self.request = dict(sha=SHA, task=TASK, bundle='b' * 64, confirm='deploy-production', action='deploy', run_id='42') self.manifest = dict(schema=1, target=cd.TARGET, sha=SHA, task=TASK, migrations=[1, 2], images={}) for role, image in IMAGES.items(): archive = self.root / (role + '.tar') archive.write_text(role) self.manifest['images'][role] = dict(id=image, sha256=hashlib.sha256(role.encode()).hexdigest()) data = json.dumps(self.manifest).encode() (self.root / 'release.json').write_bytes(data) for path in self.root.iterdir(): path.chmod(0o600) self.request['bundle'] = hashlib.sha256(data).hexdigest() self.acceptance = {'verdict': 'passed', 'sha': SHA, 'bundle': self.request['bundle'], 'evidence': 'https://example.test/result/42'} self.host = Mock() self.host.task.return_value = {'id': TASK, 'spaceId': cd.SPACE, 'status': {'id': cd.READY}, 'metadata': {'cd_acceptance': json.dumps(self.acceptance)}} self.host.baseline.return_value = {'before': 'baseline'} self.host.pre_switch.return_value = None self.host.verify.return_value = {'sha': SHA, 'images': IMAGES, 'health': 'ok'} self.host.receipt_path = self.root / 'receipt.json' self.host.bundle_path.return_value = self.root def execute(self): return cd.release(self.host, self.request) def assert_no_deploy(self): self.host.load.assert_not_called() self.host.switch.assert_not_called() self.host.callback.assert_not_called() def test_no_confirmation_has_zero_side_effects(self): self.request['confirm'] = '' with self.assertRaisesRegex(cd.CDError, 'confirmation'): self.execute() self.host.assert_not_called() self.assert_no_deploy() def test_preconditions_prevent_loading_and_switching(self): for mode in ('approval', 'ci', 'test', 'changed_bundle', 'tampered_archive', 'migration'): with self.subTest(mode=mode): self.setUp() if mode in ('approval', 'ci', 'migration'): step = {'approval': self.host.approve, 'ci': self.host.check_ci, 'migration': self.host.pre_switch}[mode] step.side_effect = cd.CDError(mode) elif mode == 'test': self.host.task.return_value['metadata'].clear() elif mode == 'changed_bundle': self.request['bundle'] = 'f' * 64 else: (self.root / 'web.tar').write_bytes(b'other image') with self.assertRaises(cd.CDError): self.execute() self.assert_no_deploy() def test_bare_ci_success_cannot_replace_required_context(self): for statuses in ([], [{'context': 'different', 'status': 'success'}], [{'context': CTX, 'status': 'failure'}, {'context': CTX, 'status': 'success'}]): with self.assertRaises(cd.CDError): cd.verify_contexts({'state': 'success', 'statuses': statuses}, [CTX]) cd.verify_contexts({'state': 'success', 'statuses': [{'context': CTX, 'status': 'success'}]}, [CTX]) def test_approval_and_acceptance_rechecked_before_switch(self): self.host.approve.side_effect = [None, cd.CDError('revoked')] with self.assertRaisesRegex(cd.CDError, 'revoked'): self.execute() self.host.switch.assert_not_called() self.host.callback.assert_not_called() def test_success_and_writeback_retry_do_not_switch_twice(self): self.host.callback.side_effect = [cd.CDError('HiFox timeout'), None] with self.assertRaisesRegex(cd.CDError, 'DEPLOYED_HIFOX_PENDING'): self.execute() self.assertEqual(cd.read_json(self.host.receipt_path)['state'], 'deployed_hifox_pending') self.request.update(action='writeback', confirm='retry-writeback') self.assertEqual(self.execute()['state'], 'published') self.host.switch.assert_called_once() self.host.load.assert_called_once() self.assertEqual(self.host.verify.call_count, 2) def test_writeback_without_receipt_refuses(self): self.request.update(action='writeback', confirm='retry-writeback') with self.assertRaisesRegex(cd.CDError, 'receipt'): self.execute() self.assert_no_deploy() def test_failed_cutover_rolls_back_and_never_marks_published(self): for result in ('rolled_back', 'rollback_failed'): with self.subTest(result=result): self.setUp() self.host.verify.side_effect = cd.CDError('new unhealthy') if result == 'rollback_failed': self.host.rollback.side_effect = cd.CDError('old unhealthy') with self.assertRaisesRegex(cd.CDError, result): self.execute() self.assertEqual(cd.read_json(self.host.receipt_path)['state'], result) self.host.rollback.assert_called_once() self.host.callback.assert_not_called() with self.assertRaisesRegex(cd.CDError, 'receipt'): self.execute() self.host.switch.assert_called_once() def test_gitea_guard_log_binds_the_exact_dispatch(self): trusted = 'f' * 40 proof = cd.guard_proof(self.request, trusted) log = f'2026-11-22T17:31:54.013Z {proof}\n'.encode() cd.verify_guard_log(log, self.request, trusted) for name, altered in (('sha', 'b' * 40), ('bundle', 'c' * 64), ('run_id', '43'), ('task', 'd5abdf29-d0b5-4992-8073-0cb8fffd84ee2'), ('confirm', 'retry-writeback')): with self.subTest(name=name), self.assertRaisesRegex(cd.CDError, 'dispatch proof'): cd.verify_guard_log(log, {**self.request, name: altered}, trusted) with self.assertRaisesRegex(cd.CDError, 'dispatch proof'): cd.verify_guard_log(log + log, self.request, trusted) def hifox_fixture(self): task = self.host.task.return_value report = 'ba3ced78-e648-47de-9c17-bccb8f31f36f' event = 'a3aa1dbe-4082-4972-8e29-ed3e39e26b30' task.update(url='https://app.hifox.com/example/task/TEST-42', statusChangedAt='2026-11-22T18:00:00Z') self.acceptance['evidence'] = task['url'] + '#comment-' + report task['metadata']['cd_acceptance'] = json.dumps(self.acceptance) timeline = [dict(id=report, event='commented', createdAt='2026-11-22T17:59:00Z', content=f'验收通过 {SHA} {self.request["bundle"]}'), dict(id=event, event='status_changed', createdAt=task['statusChangedAt'], actor={'type': 'human', 'id': cd.RELEASE_OWNER}, metadata={'to': '待发布'})] return task, timeline def test_hifox_dispatch_claims_one_transition(self): task, timeline = self.hifox_fixture() timeline[-1]['createdAt'] = '2026-11-22T18:00:01Z' cd.atomic_write(self.root / 'active-since', b'2026-11-22T17:55:00Z\n') with patch.object(trigger, 'hifox', side_effect=[task, timeline, task, timeline]), \ patch.object(trigger, 'forge', return_value={'workflow_run_id': 42}) as dispatch: first = trigger.queue(TASK, 'unused', self.root) replay = trigger.queue(TASK, 'unused', self.root) self.assertEqual(first, replay) self.assertEqual(first['run_id'], '42') dispatch.assert_called_once_with('POST', trigger.DISPATCH, {'ref': 'main', 'inputs': first['inputs']}) self.assertEqual(first['inputs']['approval_event'], timeline[-1]['id']) def test_unknown_dispatch_outcome_is_held(self): task, timeline = self.hifox_fixture() cd.atomic_write(self.root / 'active-since', b'2026-11-22T17:55:00Z\n') with patch.object(trigger, 'hifox', side_effect=[task, timeline, task, timeline]), \ patch.object(trigger, 'forge', side_effect=TimeoutError()) as dispatch: with self.assertRaises(TimeoutError): trigger.queue(TASK, 'unused', self.root) with self.assertRaisesRegex(cd.CDError, 'outcome unknown'): trigger.queue(TASK, 'unused', self.root) dispatch.assert_called_once() def test_hifox_gate_requires_owner_and_existing_candidate_report(self): for failure in ('agent', 'other human', 'mismatched report', 'updated report', 'stale transition', 'no evidence'): with self.subTest(failure=failure): task, timeline = self.hifox_fixture() if failure == 'agent': timeline[-1]['actor']['type'] = 'agent' if failure == 'other human': timeline[-1]['actor']['id'] = TASK if failure == 'mismatched report': timeline[0]['content'] = SHA if failure == 'updated report': timeline[0]['updatedAt'] = '2026-11-22T19:00:00Z' if failure == 'stale transition': task['statusChangedAt'] = '2026-11-22T19:00:00Z' if failure == 'no evidence': task['metadata'] = {} with patch.object(trigger, 'hifox', side_effect=[task, timeline]), patch.object(trigger, 'forge') as forge: with self.assertRaises(cd.CDError): trigger.queue(TASK, 'unused', self.root) forge.assert_not_called() def test_auto_approval_is_checked_again_before_switch(self): task, timeline = self.hifox_fixture() approval, _ = cd.release_approval(task, timeline, self.request) self.request.update(approval) self.host.timeline.side_effect = [timeline, timeline[:-1]] proof = cd.guard_proof(self.request, 'f' * 40) self.assertNotEqual(proof, cd.guard_proof({**self.request, 'acceptance_digest': 'e' * 64}, 'f' * 40)) with self.assertRaisesRegex(cd.CDError, 'status history'): self.execute() self.host.switch.assert_not_called() def test_target_lock_is_exclusive(self): path = self.root / 'lock' with cd.deploy_lock(path): with self.assertRaisesRegex(cd.CDError, 'deployment lock'): with cd.deploy_lock(path): self.fail('lock was acquired twice') def test_persisted_compose_changes_only_images(self): original = {'services': {role: {'image': role + ':old', 'env_file': [{'path': '/kept', 'format': 'raw'}], 'volumes': ['/kept:/run/key:ro'], 'environment': {'GATE': 'true'}} for role in IMAGES}, 'name': 'governance'} changed = cd.with_images(original, IMAGES) for role, new in changed['services'].items(): self.assertEqual(new.pop('image'), IMAGES[role]) old = original['services'][role].copy() old.pop('image') self.assertEqual(new, old) if __name__ == '__main__': unittest.main()