K8s集群中LocalStack与Serverless Framework通信故障求助

问题现象 #

执行serverless deploy --stage local时出现以下错误：

Skip plugin function AwsDeploy.extendedValidate (lambda.mountCode flag is enabled)
× Stack aws-python-http-api-project-loom-local failed to deploy (27s)
Environment: linux, node 18.20.4, framework 3.39.0, plugin 7.2.3, SDK 4.5.1
Credentials: Local, environment variables
Docs:        docs.serverless.com
Support:     forum.serverless.com
Bugs:        github.com/serverless/serverless/issues
Error:
Inaccessible host: `localstack' at port `undefined'. This service may not be available in the `***' region.
 x  Error deploying application: error executing command 'Deploy Serverless application to LocalStack': exit status 1

已确认Kubernetes中已创建名为localstack的服务，但Serverless Framework未正确识别指定的4566端口。

用户操作步骤 #

1. 安装Serverless Framework及LocalStack插件：

   npm install -g serverless@3.39.0
   npm install --save-dev serverless-localstack
   

2. 通过Helm部署LocalStack：

   cat << EOF > /tmp/values.yaml
           startServices: "lambda,apigateway"
           service:
             type: ClusterIP
           enableStartupScripts: true
           startupScriptContent: |
             echo "Starting LocalStack for lambda and API Gateway..."
           EOF
   
   helm upgrade --install localstack https://github.com/localstack/helm-charts/releases/download/localstack-0.6.1/localstack-0.6.1.tgz -f /tmp/values.yaml
   

3. 设置环境变量：

   export AWS_REGION=us-west-1
   export AWS_ACCESS_KEY_ID=test
   export AWS_SECRET_ACCESS_KEY=test
   export AWS_ENDPOINT_URL=http://localstack:4566
   

4. serverless.yaml配置：

   service: aws-python-http-api-project-loom
   frameworkVersion: "3"
   
   provider:
     name: aws
     runtime: python3.9
     region: us-west-1
   
   functions:
     hello:
       handler: handler.hello
       events:
         - http:
             path: /
             method: get
   
   plugins:
     - serverless-localstack
   
   custom:
     localstack:
       stages:
         - local
       host: http://localstack
       edgePort: 4566
       lambda:
         mountCode: True
   

调试与解决方法 #

1. 修正Serverless配置中的LocalStack地址 #

serverless.yaml中custom.localstack.host配置的http://前缀会导致插件解析地址异常，去掉前缀即可：

custom:
  localstack:
    stages:
      - local
    host: localstack  # 移除http://前缀
    edgePort: 4566
    lambda:
      mountCode: True

插件会自动拼接协议和端口，生成正确的端点地址http://localstack:4566。

2. 验证LocalStack服务的可达性 #

在运行Serverless命令的容器中，先测试连通性：

# 测试DNS解析是否正常
nslookup localstack
# 测试端口是否可访问
curl http://localstack:4566/health

若DNS解析失败，说明容器所在命名空间无法访问LocalStack的命名空间，需使用完整服务域名，例如LocalStack安装在default命名空间，而Serverless容器在dev命名空间，则地址应为localstack.default.svc.cluster.local。

3. 统一端点配置，避免冲突 #

在serverless.yaml的provider部分直接指定各服务的端点，确保与环境变量一致：

provider:
  name: aws
  runtime: python3.9
  region: us-west-1
  # 配置LocalStack端点
  endpoints:
    lambda: http://localstack:4566
    apigateway: http://localstack:4566
  environment:
    AWS_ENDPOINT_URL: http://localstack:4566

4. 确认LocalStack服务的端口映射 #

检查Kubernetes服务是否正确暴露4566端口：

kubectl describe service localstack

若Ports部分无4566:4566/TCP映射，需修改Helm values.yaml：

service:
  type: ClusterIP
  ports:
    - name: edge
      port: 4566
      targetPort: 4566

然后重新升级Helm Release：

helm upgrade --install localstack https://github.com/localstack/helm-charts/releases/download/localstack-0.6.1/localstack-0.6.1.tgz -f /tmp/values.yaml

5. 检查插件版本兼容性 #

当前Serverless 3.39.0与插件7.2.3需确保兼容，可尝试更新插件到最新兼容版本：

npm install --save-dev serverless-localstack@latest

内容的提问来源于stack exchange，提问作者Arsh Sharma