magic-pocket-cli 0.34.0__tar.gz → 0.35.0__tar.gz

{magic_pocket_cli-0.34.0 → magic_pocket_cli-0.35.0}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.5
 Name: magic-pocket-cli
-Version: 0.34.0
+Version: 0.35.0
 Summary: CLI and deploy tools for magic-pocket.
 Requires-Python: >=3.10
 Requires-Dist: awscrt>=0.19.0
 Requires-Dist: click>=8.1.7
 Requires-Dist: deepdiff>=6.7.1
 Requires-Dist: jinja2>=3.1.3
-Requires-Dist: magic-pocket<0.35,>=0.34.0
+Requires-Dist: magic-pocket<0.36,>=0.35.0
 Requires-Dist: pathspec>=1.0.4
 Requires-Dist: python-on-whales>=0.68.0
 Requires-Dist: pyyaml>=6.0.1

magic_pocket_cli-0.35.0/pocket_cli/cli/build_cli.py

@@ -0,0 +1,44 @@
+"""フレームワーク共通の build once コマンド。"""
+
+import click
+
+from pocket.context import Context, get_commit_hash, is_working_tree_dirty
+from pocket.utils import echo
+from pocket_cli.cli.aws_auth import check_aws_credentials
+from pocket_cli.cli.deploy_cli import build_image
+
+
+@click.command()
+@click.option("--stage", envvar="POCKET_DEPLOY_STAGE", prompt=True)
+@click.option(
+    "--allow-dirty",
+    is_flag=True,
+    default=False,
+    help="working tree が dirty でも build する (ローカル検証用)",
+)
+def build(stage: str, allow_dirty: bool):
+    """現在の作業ツリーを build し、git commit hash をタグにして ECR へ push する。
+
+    deploy はしない (build once)。`pocket promote --commit-hash <sha>` で
+    このイメージへ昇格する。タグは COMMIT_HASH 環境変数があればそれを、なければ
+    `git rev-parse HEAD` を使う。
+
+    commit hash = image 内容 の同一性が前提のため、working tree が dirty の場合は
+    エラーになる (--allow-dirty で回避可能)。
+    """
+    check_aws_credentials()
+    if not allow_dirty and is_working_tree_dirty():
+        raise click.ClickException(
+            "working tree に未コミットの変更があります。build once では"
+            " commit hash と image 内容の一致が前提のため、commit してから"
+            " build してください (--allow-dirty で回避できますが、その image の"
+            " 昇格は推奨しません)。"
+        )
+    try:
+        tag = get_commit_hash()
+    except RuntimeError as e:
+        raise click.ClickException(str(e)) from e
+    context = Context.from_toml(stage=stage)
+    targets = build_image(context, tag=tag)
+    for target in targets:
+        echo.success("built and pushed: %s" % target)

{magic_pocket_cli-0.34.0 → magic_pocket_cli-0.35.0}/pocket_cli/cli/deploy_cli.py

@@ -4,6 +4,7 @@ import webbrowser
 import click
 
 from pocket.context import Context, deploy_hash_report
+from pocket.settings import parse_handler_ref
 from pocket.utils import echo
 from pocket_cli import migrations
 from pocket_cli.cli import interaction
@@ -20,6 +21,11 @@ from pocket_cli.resources.cloudfront_keys import CloudFrontKeys
 from pocket_cli.resources.cloudfront_waf import CloudFrontWaf
 from pocket_cli.resources.container import Container
 from pocket_cli.resources.dsql import Dsql
+from pocket_cli.resources.inbound import (
+    Inbound,
+    check_removed_inbound,
+    echo_inbound_details,
+)
 from pocket_cli.resources.neon import Neon
 from pocket_cli.resources.rds import Rds
 from pocket_cli.resources.s3 import S3
@@ -82,6 +88,7 @@ def get_resources(context: Context, *, state_bucket: str = ""):
     if context.s3:
         resources.append(S3(context.s3, cloudfront_contexts=context.cloudfront))
     _append_infra_resources(resources, context, state_bucket)
+    resources.extend(Inbound(ctx) for ctx in context.inbound.values())
     for _name, cf_ctx in context.cloudfront.items():
         resources.append(CloudFront(cf_ctx))
     return resources
@@ -209,6 +216,11 @@ def _deploy_pipeline(context: Context, *, openpath=None, skip_frontend=False):
     """
     # DEPLOY_HASH の解決結果を deploy 時に 1 回可視化する (env 伝播漏れで
     # 黙って git short hash に落ちる footgun の早期発見用)。
+    for inlet in context.inbound.values():
+        container_name, _ = parse_handler_ref(inlet.config.handler)
+        if not context.container[container_name].permissions_boundary:
+            raise ValueError("inbound workerにpermissions_boundaryが必要です")
+        Inbound(inlet).prepare_deploy()
     deploy_hash_message = deploy_hash_report(context)
     if deploy_hash_message:
         echo.info(deploy_hash_message)
@@ -216,6 +228,7 @@ def _deploy_pipeline(context: Context, *, openpath=None, skip_frontend=False):
     state_store = _create_state_store(context)
     state_store.ensure_bucket()
     state_bucket = state_store.bucket_name
+    check_removed_inbound(context, state_store)
     deploy_init_resources(context, state_bucket=state_bucket)
     deploy_resources(context, state_bucket=state_bucket)
     # リリース跨ぎ移行の掃除フェーズ (旧配置の削除は deploy 成功後にしか
@@ -229,6 +242,7 @@ def _deploy_pipeline(context: Context, *, openpath=None, skip_frontend=False):
     # DLQ アラートの email 購読が未確認のままだと通知が届かないため、
     # deploy の最後に購読状態を確認して警告する
     echo_dead_letter_alert_warnings(context)
+    echo_inbound_details(context)
     # デプロイ完了後の URL 表示
     url = _get_deploy_url(context)
     if url:
@@ -266,7 +280,7 @@ def deploy(stage: str, openpath, skip_frontend, yes):
 def promote(stage: str, commit_hash, openpath, skip_frontend, yes):
     """build 済みの :<commit-hash> image へ stage を向けて deploy する (再ビルドなし)。
 
-    `pocket django build` で push した image に :<stage> タグを移し、
+    `pocket build` で push した image に :<stage> タグを移し、
     インフラ/Lambda を更新する。image build は行わない (build once の昇格)。
     """
     from pocket_cli.cli.aws_auth import check_aws_credentials

{magic_pocket_cli-0.34.0 → magic_pocket_cli-0.35.0}/pocket_cli/cli/destroy_cli.py

@@ -3,6 +3,12 @@ import click
 
 from pocket.context import Context
 from pocket.utils import echo
+from pocket_cli.migrations import (
+    legacy_container_stack_exists,
+    legacy_container_stack_name,
+    legacy_ecr_repo_exists,
+    legacy_ecr_repo_name,
+)
 from pocket_cli.resources.aws.builders.codebuild import CodeBuildBuilder
 from pocket_cli.resources.aws.state import (
     context_resource_prefix,
@@ -14,6 +20,7 @@ from pocket_cli.resources.cloudfront_acm import CloudFrontAcm
 from pocket_cli.resources.cloudfront_keys import CloudFrontKeys
 from pocket_cli.resources.container import Container
 from pocket_cli.resources.dsql import Dsql
+from pocket_cli.resources.inbound import Inbound
 from pocket_cli.resources.neon import Neon
 from pocket_cli.resources.rds import Rds
 from pocket_cli.resources.s3 import S3
@@ -89,6 +96,8 @@ def _collect_container_targets(context: Context, with_secrets: bool):
                 parts.append("ECR")
         targets.append("Container '%s' (%s)" % (c_name, " + ".join(parts)))
 
+    targets.extend(_collect_legacy_container_targets(context))
+
     parts = []
     has_secrets = context.secrets or any(c.secrets for c in context.container.values())
     if with_secrets and has_secrets:
@@ -105,6 +114,38 @@ def _collect_container_targets(context: Context, with_secrets: bool):
     return targets
 
 
+def _collect_legacy_container_targets(context: Context) -> list[str]:
+    """0.29.0 以前の単数 [awscontainer] 命名 ({slug}-container) の残骸を削除対象にする。
+
+    移行 deploy を経ずに旧 stack だけ消したいケース (region 移設・廃止) では
+    現行命名の stack が NOEXIST で destroy の対象から漏れるため (KN1456)。
+    """
+    targets: list[str] = []
+    if legacy_container_stack_exists(context):
+        targets.append(
+            "旧形式の container stack '%s' (0.29.0 以前の [awscontainer] 命名。"
+            "CFNスタック)" % legacy_container_stack_name(context)
+        )
+    if legacy_ecr_repo_exists(context):
+        targets.append(
+            "旧形式の ECR repository '%s' (0.29.0 以前の命名)"
+            % legacy_ecr_repo_name(context)
+        )
+    return targets
+
+
+def _neon_credential_missing(context: Context) -> bool:
+    """[neon] 宣言があるのに NEON_API_KEY が無ければ warning を出して True。"""
+    if not context.neon or context.neon.api_key:
+        return False
+    echo.warning(
+        "Neon: NEON_API_KEY が未設定のため Neon の確認・削除をスキップします "
+        "(stack の削除に Neon の資格情報は不要です。Neon branch は "
+        "pocket resource neon delete か Neon コンソールで削除してください)。"
+    )
+    return True
+
+
 def _warn_command_provisioned(label: str, hint: str):
     echo.warning(
         '%s は provisioning="command" のため destroy では削除しません。'
@@ -144,7 +185,11 @@ def _collect_external_database_targets(context: Context) -> list[str]:
     if context.upstash and context.upstash.provisioning != "command":
         if Upstash(context.upstash).database:
             targets.append("Upstash Redis: %s" % context.upstash.database_name)
-    if context.neon and context.neon.provisioning != "command":
+    if (
+        context.neon
+        and context.neon.provisioning != "command"
+        and not _neon_credential_missing(context)
+    ):
         neon = Neon(context.neon)
         if neon.branch:
             plan = neon.destroy_plan()
@@ -176,6 +221,9 @@ def _collect_targets(context: Context, with_secrets: bool, with_state_bucket: bo
         if cf_ctx.domain:
             targets.append("CloudFront ACM '%s' (us-east-1 証明書)" % name)
 
+    targets.extend(
+        f"Inbound {name} (原本バケットと配送DLQは保持)" for name in context.inbound
+    )
     targets.extend(_collect_container_targets(context, with_secrets))
     targets.extend(_collect_database_targets(context))
     targets.extend(_collect_vpc_targets(context))
@@ -247,6 +295,8 @@ def _destroy_containers(context: Context, with_secrets: bool):
                 c.ecr.delete()
                 echo.success("ECR repository was deleted.")
 
+    _destroy_legacy_containers(context)
+
     _destroy_codebuild(context)
 
     _destroy_log_groups(context)
@@ -263,6 +313,43 @@ def _destroy_containers(context: Context, with_secrets: bool):
             echo.success("Pocket managed secrets were deleted.")
 
 
+def _destroy_legacy_containers(context: Context):
+    """0.29.0 以前の命名の container stack / ECR repo / log group を削除する。"""
+    if not context.general:
+        return
+    region = context.general.region
+    if legacy_container_stack_exists(context):
+        stack_name = legacy_container_stack_name(context)
+        cfn = boto3.client("cloudformation", region_name=region)
+        echo.log("Destroying legacy container stack '%s'..." % stack_name)
+        cfn.delete_stack(StackName=stack_name)
+        # 現行 stack と同様、ENI 解放を含む削除完了を待たないと後続の VPC 削除が
+        # subnet 使用中で DELETE_FAILED になる
+        cfn.get_waiter("stack_delete_complete").wait(
+            StackName=stack_name, WaiterConfig={"Delay": 10, "MaxAttempts": 180}
+        )
+        echo.success("Legacy container stack '%s' was destroyed." % stack_name)
+    if legacy_ecr_repo_exists(context):
+        repo = legacy_ecr_repo_name(context)
+        ecr = boto3.client("ecr", region_name=region)
+        echo.log("Destroying legacy ECR repository '%s'..." % repo)
+        ecr.delete_repository(repositoryName=repo, force=True)
+        echo.success("Legacy ECR repository was deleted.")
+    # 旧命名の Lambda ({prefix}{handler}) が自動作成した log group
+    prefix = context_resource_prefix(context)
+    logs_client = boto3.client("logs", region_name=region)
+    handler_keys = sorted(
+        {key for c in context.container.values() for key in c.handlers}
+    )
+    for key in handler_keys:
+        log_group_name = f"/aws/lambda/{prefix}{key}"
+        try:
+            logs_client.delete_log_group(logGroupName=log_group_name)
+            echo.log("Deleted legacy log group: %s" % log_group_name)
+        except logs_client.exceptions.ResourceNotFoundException:
+            pass
+
+
 def _destroy_backup(context: Context, yes: bool):
     """backup plan / selection を削除し、recovery point の扱いを案内する。
 
@@ -386,6 +473,8 @@ def _destroy_neon(context: Context):
     if context.neon.provisioning == "command":
         _warn_command_provisioned("Neon", "pocket resource neon delete")
         return
+    if _neon_credential_missing(context):
+        return
     neon = Neon(context.neon)
     if not neon.branch:
         return
@@ -431,6 +520,9 @@ def _destroy_resources(
     yes: bool = False,
 ):
     """リソースをデプロイの逆順で削除"""
+    for inlet in context.inbound.values():
+        Inbound(inlet).delete()
+
     # 1. CloudFront + ACM
     _destroy_cloudfront_and_acm(context)
 

magic_pocket_cli-0.35.0/pocket_cli/cli/inbound_cli.py

@@ -0,0 +1,288 @@
+"""受信口の初期設定と原本・受信情報の運用コマンド。"""
+
+import hashlib
+import json
+
+import boto3
+import click
+from botocore.config import Config
+
+from pocket.inbound import SETUP_NOTIFICATION, receipt_id, validate_receipt_id
+from pocket.inbound_context import InboundContext
+from pocket.settings import Settings, parse_handler_ref
+from pocket_cli.resources.inbound import Inbound
+
+
+@click.group()
+@click.option("--stage", envvar="POCKET_DEPLOY_STAGE", required=True)
+@click.option("--name", required=True, help="inboundの設定名")
+@click.pass_context
+def inbound(ctx, stage, name):
+    """SES受信口を管理する。"""
+    settings = Settings.from_toml(stage=stage)
+    if name not in settings.inbound:
+        raise click.ClickException(f"inbound.{name} がありません")
+    ctx.obj = Inbound(InboundContext.from_settings(name, settings))
+    ctx.meta["settings"] = settings
+
+
+@inbound.command()
+@click.pass_obj
+def init(resource):
+    """共有rule setの初期化とドメイン検証の申請（初回のみ）。"""
+    ses = boto3.client("ses", region_name=resource.context.region)
+    active = ses.describe_active_receipt_rule_set().get("Metadata", {}).get("Name")
+    if not active:
+        name = "pocket-inbound"
+        names = [
+            item["Name"]
+            for page in ses.get_paginator("list_receipt_rule_sets").paginate()
+            for item in page["RuleSets"]
+        ]
+        if name in names:
+            raise click.ClickException(
+                "pocket-inboundが既にあります。内容を確認し管理者が有効化してください"
+            )
+        click.confirm(
+            "このaccount/regionで初期化を同時実行していないことを確認してください。"
+            "共有rule set pocket-inboundを作成・有効化しますか？",
+            abort=True,
+        )
+        if ses.describe_active_receipt_rule_set().get("Metadata"):
+            raise click.ClickException("active setが変わりました。再実行してください")
+        ses.create_receipt_rule_set(RuleSetName=name)
+        if ses.describe_active_receipt_rule_set().get("Metadata"):
+            raise click.ClickException(
+                "初期化中にactive setが変わりました。有効化を中止します"
+            )
+        ses.set_active_receipt_rule_set(RuleSetName=name)
+        active = ses.describe_active_receipt_rule_set().get("Metadata", {}).get("Name")
+        if active != name:
+            raise click.ClickException("有効化後のactive setが一致しません")
+    domain = resource.context.config.domain
+    result = ses.get_identity_verification_attributes(Identities=[domain])
+    identity = result.get("VerificationAttributes", {}).get(domain, {})
+    token = identity.get("VerificationToken")
+    if not token and identity.get("VerificationStatus") != "Success":
+        token = ses.verify_domain_identity(Domain=domain)["VerificationToken"]
+    click.echo(f"active rule set: {active}")
+    if token:
+        click.echo(f"TXT _amazonses.{domain} {token}")
+    click.echo(f"MX {domain} 10 inbound-smtp.{resource.context.region}.amazonaws.com")
+    click.echo("SES受信対応リージョンとMXの既存配送先を確認してDNSを登録してください。")
+
+
+@inbound.command()
+@click.pass_obj
+def status(resource):
+    """スタック・active set・検証状態・監視先を表示する。"""
+    resource.prepare_deploy()
+    click.echo(f"stack: {resource.stack.name} / {resource.status}")
+    click.echo(json.dumps(resource.stack.output or {}, ensure_ascii=False, indent=2))
+    if resource.context.config.delivery_alert.eventbridge:
+        click.echo(
+            "EventBridge: source=aws.cloudwatch, "
+            "detail-type=CloudWatch Alarm State Change"
+        )
+
+
+@inbound.command(name="yaml")
+@click.pass_obj
+def show_yaml(resource):
+    """active setと既存bindingを照会しテンプレートを表示する。"""
+    click.echo(resource.stack.yaml)
+
+
+@inbound.command()
+@click.pass_obj
+def destroy(resource):
+    """無効化・配送猶予・滞留解消後に自分のルールとスタックを削除する。"""
+    click.confirm(
+        "受信停止後36時間以上経過し、原本の照合・必要な退避を終えましたか？", abort=True
+    )
+    resource.delete()
+
+
+@inbound.command()
+@click.pass_obj
+def reconcile(resource):
+    """原本に対応する受信情報の欠落を検出する（復元・推測はしない）。"""
+    output = resource.stack.output
+    if not output:
+        raise click.ClickException("受信スタックがありません")
+    bucket = output["Bucket"]
+    s3 = boto3.client("s3", region_name=resource.context.region)
+    config = resource.context.config
+    metadata = {
+        item["Key"]
+        for page in s3.get_paginator("list_objects_v2").paginate(
+            Bucket=bucket, Prefix=config.metadata_prefix
+        )
+        for item in page.get("Contents", [])
+    }
+    missing = 0
+    for page in s3.get_paginator("list_objects_v2").paginate(
+        Bucket=bucket, Prefix=config.raw_prefix
+    ):
+        for item in page.get("Contents", []):
+            if item["Key"] == config.raw_prefix + SETUP_NOTIFICATION:
+                continue
+            identifier = receipt_id(bucket, item["Key"])
+            if config.metadata_prefix + identifier + ".json" not in metadata:
+                click.echo(f"受信情報なし: {item['Key']} / {identifier}")
+                missing += 1
+    if missing:
+        raise click.ClickException(
+            f"{missing}件の受信情報がありません。通知の遅延・DLQを確認してください"
+        )
+    click.echo("原本に対応する受信情報を確認しました。")
+
+
+@inbound.command(name="copy")
+@click.option("--receipt-id", "identifier", required=True)
+@click.option("--to-stage", required=True)
+@click.option("--to-name", required=True)
+@click.pass_obj
+def copy_receipt(resource, identifier, to_stage, to_name):
+    """指定した1件の原本と受信情報を別stageへコピーしmanifestを最後に保存する。"""
+    validate_receipt_id(identifier)
+    settings = Settings.from_toml(stage=to_stage)
+    if to_name not in settings.inbound:
+        raise click.ClickException(f"コピー先のinbound.{to_name}がありません")
+    target = Inbound(InboundContext.from_settings(to_name, settings))
+    source_output, target_output = resource.stack.output, target.stack.output
+    if not source_output or not target_output:
+        raise click.ClickException("コピー元と先の受信スタックが必要です")
+    source = boto3.client("s3", region_name=resource.context.region)
+    destination = boto3.client("s3", region_name=target.context.region)
+    key = resource.context.config.metadata_prefix + identifier + ".json"
+    metadata_bytes = source.get_object(Bucket=source_output["Bucket"], Key=key)[
+        "Body"
+    ].read()
+    metadata = json.loads(metadata_bytes)
+    reference = metadata["source"]
+    if reference["bucket"] != source_output["Bucket"] or not reference[
+        "key"
+    ].startswith(resource.context.config.raw_prefix):
+        raise click.ClickException("原本の参照先が設定と一致しません")
+    raw = source.get_object(
+        Bucket=reference["bucket"],
+        Key=reference["key"],
+        VersionId=reference["version_id"],
+    )["Body"].read()
+    if (
+        metadata["receipt_id"] != identifier
+        or hashlib.sha256(raw).hexdigest() != reference["sha256"]
+    ):
+        raise click.ClickException("原本のhashまたは受信IDが一致しません")
+    # 同じ受信IDのcopyは同じ内容になる。manifestが揃うまで解析ジョブを投入しない。
+    prefix = target.context.config.import_prefix + identifier + "/"
+    for suffix, body, content_type in (
+        ("raw.eml", raw, "message/rfc822"),
+        ("metadata.json", metadata_bytes, "application/json"),
+        (
+            "manifest.json",
+            json.dumps({"schema_version": 1, "receipt_id": identifier}).encode(),
+            "application/json",
+        ),
+    ):
+        destination.put_object(
+            Bucket=target_output["Bucket"],
+            Key=prefix + suffix,
+            Body=body,
+            ContentType=content_type,
+        )
+    click.echo(prefix + "manifest.json")
+    click.echo(
+        "コピー完了。取り込み用handlerからReceiver.load_importで明示的に解析してください。"
+    )
+
+
+@inbound.command(name="import")
+@click.option("--manifest-key", required=True)
+@click.option("--handler", "handler_ref", required=True, help="取り込み用handlerの参照")
+@click.pass_context
+def import_receipt(ctx, manifest_key, handler_ref):
+    """コピー済みmanifestを指定し、利用側の取り込みhandlerを同期実行する。"""
+    resource = ctx.obj
+    settings = ctx.meta["settings"]
+    container, key, _ = settings.resolve_handler(handler_ref)
+    receiving_container, _ = parse_handler_ref(resource.context.config.handler)
+    if (
+        container != receiving_container
+        or handler_ref == resource.context.config.handler
+    ):
+        raise click.ClickException(
+            "受信workerと同じcontainerの別handlerを指定してください"
+        )
+    if not manifest_key.startswith(
+        resource.context.config.import_prefix
+    ) or not manifest_key.endswith("/manifest.json"):
+        raise click.ClickException("imports内のmanifest.jsonを指定してください")
+    prefix = settings.prefix_template.format(**settings.format_vars)
+    client = boto3.client(
+        "lambda",
+        region_name=resource.context.region,
+        config=Config(read_timeout=900, retries={"total_max_attempts": 1}),
+    )
+    response = client.invoke(
+        FunctionName=f"{prefix}{container}-{key}",
+        InvocationType="RequestResponse",
+        Payload=json.dumps(
+            {"inbound": resource.context.name, "manifest_key": manifest_key}
+        ).encode(),
+    )
+    response["Payload"].read()
+    if response.get("FunctionError"):
+        raise click.ClickException(
+            "取り込みhandlerが失敗しました。Lambdaログを確認してください"
+        )
+    click.echo("取り込みhandlerの実行が完了しました。")
+
+
+@inbound.command()
+@click.option("--queue", type=click.Choice(["delivery", "worker"]), required=True)
+@click.option("--limit", type=click.IntRange(1, 100), default=10, show_default=True)
+@click.pass_obj
+def redrive(resource, queue, limit):
+    """DLQの保存形式を検証し、受信queueへ戻す。成功した送信だけ削除する。"""
+    output = resource.stack.output
+    if not output:
+        raise click.ClickException("受信スタックがありません")
+    sqs = boto3.client("sqs", region_name=resource.context.region)
+    source = output["DeliveryDLQUrl" if queue == "delivery" else "WorkerDLQUrl"]
+    count = 0
+    for _ in range(limit):
+        messages = sqs.receive_message(
+            QueueUrl=source, MaxNumberOfMessages=1, VisibilityTimeout=60
+        ).get("Messages", [])
+        if not messages:
+            break
+        message = messages[0]
+        envelope = json.loads(message["Body"])
+        if (
+            envelope.get("Type") != "Notification"
+            or envelope.get("TopicArn") != output["TopicArn"]
+        ):
+            raise click.ClickException(
+                "想定外の通知形式です。DLQから削除せず中止します"
+            )
+        notification = json.loads(envelope["Message"])
+        action = notification.get("receipt", {}).get("action", {})
+        if (
+            notification.get("notificationType") != "Received"
+            or action.get("type") != "S3"
+            or action.get("bucketName") != output["Bucket"]
+            or not action.get("objectKey", "").startswith(
+                resource.context.config.raw_prefix
+            )
+        ):
+            raise click.ClickException(
+                "想定外のSES保存先です。DLQから削除せず中止します"
+            )
+        sqs.send_message(QueueUrl=output["QueueUrl"], MessageBody=message["Body"])
+        sqs.delete_message(QueueUrl=source, ReceiptHandle=message["ReceiptHandle"])
+        count += 1
+    click.echo(
+        f"{count}件を受信queueへ再投入しました。重複実行に備え業務側で冪等化してください。"
+    )

{magic_pocket_cli-0.34.0 → magic_pocket_cli-0.35.0}/pocket_cli/cli/main_cli.py

@@ -16,6 +16,7 @@ except ModuleNotFoundError as e:
 
 from pocket_cli.cli import (
     backup_cli,
+    build_cli,
     cloudfront_cli,
     cloudfront_keys_cli,
     cloudfront_waf_cli,
@@ -24,6 +25,7 @@ from pocket_cli.cli import (
     destroy_cli,
     dsql_cli,
     image_cli,
+    inbound_cli,
     migrate_cli,
     neon_cli,
     permissions_cli,
@@ -121,6 +123,7 @@ def settings(stage):
     print(json.dumps(mask_secret_values(s.model_dump(mode="json")), indent=2))
 
 
+main.add_command(build_cli.build)
 main.add_command(deploy_cli.deploy)
 main.add_command(deploy_cli.promote)
 main.add_command(destroy_cli.destroy)
@@ -138,6 +141,7 @@ def resource():
     pass
 
 
+resource.add_command(inbound_cli.inbound)
 resource.add_command(vpc_cli.vpc)
 resource.add_command(container_cli.container)
 resource.add_command(neon_cli.neon)

{magic_pocket_cli-0.34.0 → magic_pocket_cli-0.35.0}/pocket_cli/cli/status_cli.py

@@ -5,9 +5,25 @@ from pocket.resources.aws.secretsmanager import PocketSecretIsNotReady
 from pocket.utils import echo
 from pocket_cli.cli.deploy_cli import get_resources
 from pocket_cli.resources.container import Container
+from pocket_cli.resources.inbound import echo_inbound_details
+from pocket_cli.resources.neon import Neon
 from pocket_cli.resources.sqs_alert import echo_dead_letter_alert_statuses
 
 
+def skip_reason(resource) -> str | None:
+    """status を取らずに skip する理由 (無ければ None)。
+
+    外部 provider の資格情報が無い環境 (例: NEON_API_KEY を持たない VM) でも、
+    stack の状態確認に provider は無関係なので止めずに続行する (KN1456)。
+    """
+    if isinstance(resource, Neon) and not resource.has_credential:
+        return (
+            "Neon status: NEON_API_KEY が未設定のため状態確認をスキップします "
+            "(stack の状態確認・削除に Neon の資格情報は不要です)"
+        )
+    return None
+
+
 def show_status_message(resource):
     target_name = resource.__class__.__name__
     message = f"{target_name} status: {resource.status}"
@@ -54,8 +70,13 @@ def status(stage, show_info):
     context = Context.from_toml(stage=stage)
     resources = get_resources(context)
     for resource in resources:
+        reason = skip_reason(resource)
+        if reason:
+            echo.warning(reason)
+            continue
         show_status_message(resource)
         if show_info:
             show_info_message(resource)
     # DLQ アラートの email 購読状態 (PendingConfirmation のままだと通知が届かない)
     echo_dead_letter_alert_statuses(context)
+    echo_inbound_details(context)