Serverless Framework Yamlの記法について

Question

問題

現在私はserverless frameworkを用いてサービスのバックエンドを担当しています。そこでfunctionの数が多いのでファイルを分けようと思い、以下のようにしました。

# ディレクトリ構成
src ----function1.yml
          |-function2.yml
serverless.yml

# function1.yml

function1:
  handler: func1
  events:
    - http:
        path: func1
        method: post

# function2.yml

function1:
  handler: func2
  events:
    - http:
        path: func2
        method: post

# serverless.yml
functions:
  - ${file(./src/function1.yml)}
  - ${file(./src/function2.yml)}

以上のように書くと

Missing "handler" property in function "0".

と行ったエラーが出てしまいます。

何かいい解決方法はないでしょうか？皆様のお知恵をお借りできれば幸いです。

Answer 1

私の誤認識で、functionsの分割は、サポートされているようです。もしエラーの解消方法が分かったら、別途回答します。

ただ、代案（serviceでの分割手法）の紹介として残させていただきます。serviceでの分割は、関連するfunctionの定義が1ファイルに集まるので、個人的には読みやすいと思います。

---

メインの serverless.ymlファイルにservice:やprovider:が記述されていないようですが、省略しているという前提で回答いたします（記述されていないとエラーになるため）

Serverlessに報告されているIssueを見ると、残念ながらfunctions定義の分割はまだサポートされていないようです。Issueがクローズされていないので、Issueに投票しておくと、将来サポートされるかもしれません。

functionの数が多いときにファイルを分割するとき手法としては、service（関連する function や設定の集まり）単位のファイル分割がサポートされています。わたしのチームでもこれを使っています。

# hoge/serverless.yml
service: hoge
provider: 省略
functions:
  getHoge: 省略
  putHoge: 省略

# fuga/serverless.yml
service: fuga
provider: 省略
functions:
  getFuga: 省略
  putFuga: 省略

どうしても functions: 定義を分割したい場合、Issue内で[回避策としてYAMLではなくJavaScriptでの記述が紹介](https://github.com/serverless/serverless/issues/4218#issuecomment-341239994 JavaScript)されています。JSで記述すると、JSプログラムとして実行できるので外部ファイルを読み込んで生成した結果をYAMLに展開する、ということができるようです。

個人的には、そこまで作り込むよりも、serviceでのファイル分割で十分ではないかと思います。

Answer 2

なぜエラーが出るのかわかりました。

以下URLをご参照ください。

https://github.com/serverless-japan/forum/issues/6

Answer 3

単純にデプロイ時に作成するLambdaFunctionが多いのであれば、一つの serverless.yml にまとめて書けば良いのではないでしょうか？
私が複数のLambdaFunctionをデプロイするときにはこのように書きます。
※function以外の部分は省略しています。

functions:
  function1:
    handler: func1
    events:
      - http:
          path: func1
          method: post
  function2:
    handler: func2
    events:
      - http:
          path: func2
          method: post

こう書くと、デプロイ時に function1 と function2 のLambdaFunctionが作成されます。
一度試してみてください。