<h1 id="hb6fd360517"># 目的</h1>AWS LambdaでバックエンドAPIを構築しているとき、関数の挙動を確認したいときは都度devにデプロイしていました。流石にローカルでの開発環境を整えたいと思ったのですがGoでの使い方の情報が少なかったので個人メモとしてまとめてみました。今回はAPI GatewayがトリガーのLambda関数になります。→<a href="https://blog.70-10.net/2018/08/29/serverless-typescript/#4-code-classlanguage-textserverless-offlinecode%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%83%AD%E3%83%BC%E3%82%AB%E3%83%AB%E3%81%A7%E5%AE%9F%E8%A1%8C%E3%81%99%E3%82%8B" target="_blank" rel="noopener noreferrer nofollow">serverless invoke local -f &lt;function&gt;で十分らしいです</a><h1 id="h0177c42637"># 全体の流れ</h1>以下のJavascript filesのところを今回はGolangにしてやってみます。引用: <a href="https://qiita.com/noralife/items/e36621ddd0e5b8ff4447#%E6%A7%8B%E6%88%90" target="_blank" rel="noopener noreferrer nofollow">https://qiita.com/noralife/items/e36621ddd0e5b8ff4447#%E6%A7%8B%E6%88%90</a>大まかな流れは以下です。1. DynamoDB Localをインストール&amp;セットアップ2. Serverless offlineをインストール &amp;セットアップ# DynamoDB Localをインストール&amp;セットアップ<h2 id="ha7f3c87dfd">## パッケージインストール</h2><pre><code>$ npm install --save-dev serverless-dynamodb-local
</code></pre><h2 id="h97dc00252e">## serverless.ymlにプラグインを追記</h2><pre><code>```serverless.yml

plugins: 
 - serverless-dynamodb-local

```
</code></pre><h2 id="ha234c3c041">## JDKがなければここでインストール</h2>dynamodb-localのためにはJavaが必要でしたので、ローカルpcにJavaを入れていない方はインストールします。インストールの仕方は、mac osだと、以下が参考になります。<a href="https://qiita.com/suke_masa/items/f9af0fb84ad9447ae961" target="_blank" rel="noopener noreferrer nofollow">https://qiita.com/suke_masa/items/f9af0fb84ad9447ae961</a><h2 id="hfd1ed606f2">## dynamo db localをインストール</h2>serverless.ymlのあるディレクトリにて、<pre><code>```sh
$ sls dynamodb install
```
</code></pre>## カスタム定義<pre><code>```serverless.yml
custom:
  dynamodb:
    stages:
     - dev
    start:
     port: 8000
     inMemory: true
     migrate: true
     seed: true
    seed:
     development:
      sources:
       - table: テーブル名
```
</code></pre>この状態で、<pre><code>```sh
sls dynamodb start
```
</code></pre>でdynamodbがローカルで立ち上がります。<code>http://localhost:8000/shell</code>にアクセスすると管理画面に移れる。シェル例<pre><code>```
var params = {
  TableName: &apos;pr_enqueteform_dev&apos;,
};
dynamodb.scan(params, function(err, data) {
  if (err) ppJson(err);
  else ppJson(data);
});
```
</code></pre><h1 id="h5c90efdc93"># Serverless offlineをインストール &amp;セットアップ</h1>次にローカルでapi gatewayを試すためにServerless offlineをインストールしていきます。<h2 id="ha7f3c87dfd">## パッケージインストール</h2><pre><code>```sh
$ npm install --save-dev serverless-offline
```
</code></pre><h2 id="he1a54a6f78">## serverless.ymlにプラグインを追加</h2><pre><code>```serverless.yml
plugins: 
 - serverless-dynamodb-local
 - serverless-offline ### 追記
```
</code></pre><h2 id="h1e1a1e1023">## カスタム定義</h2><pre><code>```serverless.yml
custom:
 serverless-offline:
  useDocker: true
```
</code></pre>この状態で<pre><code>```sh
$ npx sls offline
```
</code></pre>でローカルで起動できます。※Makefileにて、<pre><code>```sh
$ make local-test
```
</code></pre>を打つことでビルド〜offline起動までやってくれるようにしています。例:<pre><code>```sh
$ npx sls offline
Serverless: Deprecation warning: CLI options definitions were upgraded with &lt;中略&gt;
  ┌───────────────────────────────────────────────────────────────────────────────────────┐
  │                                            │
  │  POST | http://localhost:3000/dev/submit                       │
  │  POST | http://localhost:3000/2015-03-31/functions/EnqueteformReceiver/invocations  │
  │                                            │
  └───────────────────────────────────────────────────────────────────────────────────────┘

offline: [HTTP] server ready: http://localhost:3000 🚀
offline:
offline: Enter &quot;rp&quot; to replay the last request

offline: POST /dev/submit (λ: EnqueteformReceiver)
```
</code></pre>上記みたいな感じになっていたら立ち上がっています🎉<h1 id="he1c3637988"># offlineとdynamodb-localを疎通させる</h1>localでofflineを使ってlambda apiを叩いてログを出力してみると、handlerのeventsの中の、<code>events.APIGatewayProxyRequest.RequestContext.APIID</code>が <code>&quot;offlineContext_apiId&quot;</code>　となっていました。そこで、この部分で判断して、localのdynamodbクライアントを生成するか本番用のdynamodbクライアントを生成するかを条件分岐させることにします。localのdynamodbクライアントの生成方法は以下でやります。<pre><code>```go
func (c *DynamoDBClient) OfflineDynamoDBClient(region string, tableName string) *DynamoDBClient {
	sess := session.Must(session.NewSession())
	config := aws.Config{
		Region: aws.String(region),
		Endpoint: aws.String(&quot;http://host.docker.internal:8000&quot;),
		DisableSSL: aws.Bool(true),
		Credentials: credentials.NewStaticCredentials(&quot;dummy&quot;, &quot;dummy&quot;, &quot;dummy&quot;),
	}

	dynamodbClient := DynamoDBClient{
		tableName: tableName,
		dynamo:  dynamodb.New(sess, &amp;config),
	}

	return &amp;dynamodbClient
}
```
</code></pre>※もっとよい判定方法がありそうな感じです。<h1 id="hc6afa5e752"># 試してみる</h1>ローカルでコードを編集した後、一度ビルドしなければローカルの方にも反映されませんので、<pre><code>```sh
$ make clean
$ make build
$ npx sls offline
```
</code></pre>とします。<h2 id="h7a4b09ca25">## curlで疎通してみる</h2>sls offlineしたターミナルとは別のタブにて、<pre><code>```sh
curl http://localhost:3000/dev/submit -X POST -H &quot;Content-Type: application/json&quot; -d &apos;{&quot;category&quot;:&quot;hogecategory&quot;,&quot;email&quot;:&quot;sample@gmail.com&quot;,&quot;address&quot;:&quot;東京都&quot;, &quot;hoge&quot;:{&quot;id&quot;:&quot;1001&quot;,&quot;text&quot;:&quot;hogehoge&quot;}}&apos;
```
</code></pre>sls offlineしたターミナルのタブにてログが出てくる。<pre><code>```sh
START RequestId: d09*7296d-***-1c72-545b-5**c58d99034 Version: $LATEST

&lt;中略&gt;

END RequestId: d09729?6d-b4e2-1c72-5*45b-5e**ec58d99034
REPORT RequestId: d09?7296d-*b4e2-1c72-545b-5c5*d99034	Init Duration: 189.68 ms	Duration: 5513.25 ms	Billed Duration: 5514 ms	Memory Size: 3008 MB	Max Memory Used: 34 MB
```
</code></pre>実際にローカルのdynamoDBにデータを挿入する関数であれば、<code>http://localhost:8000/shell</code>をみてみると挿入されていることが確認できます！<h1 id="h77cbd11e45"># 参考</h1><a href="https://qiita.com/frozenbonito/items/effcc31ca2117789f0e9" target="_blank" rel="noopener noreferrer nofollow">Serverless Framework での AWS Lambda + Go ローカル開発事情</a><a href="https://qiita.com/noralife/items/e36621ddd0e5b8ff4447" target="_blank" rel="noopener noreferrer nofollow">Serverless アプリケーションをローカルで開発する</a><a href="https://zenn.dev/maruware/articles/cac0052812c2e3293dd5" target="_blank" rel="noopener noreferrer nofollow">serverless framework + TypeScript +DynamoDB のローカル環境</a><a href="https://bearmini.hatenablog.com/entry/2015/10/09/233849" target="_blank" rel="noopener noreferrer nofollow">Go で DynamoDB Local を使った時にいろいろハマったのでメモ</a><a href="https://gist.github.com/Tamal/02776c3e2db7eec73c001225ff52e827" target="_blank" rel="noopener noreferrer nofollow">example</a>

AWSLambda(Golang)×DynamoDBのローカ...

<h2 id="h09f1fa4532">何がやりたかったか</h2>こういうやつ↓<h2 id="hcf83e1357e"></h2>リストがあって、それを特定個で区切ってページごとに表示するやつです。ページネーションとかナビゲーションとか言ったりするやつです。結論から言うと、よくある3ページ目、5ページ目などの特定のページへ飛べるページネーションはおそらく実装不可能です。上記画像のように次のインデックス前のインデックスなどでしかできません。こういうやつ↓<h2 id="h8a175a9b0e">前提</h2><ul><li>Lambdaでの、AWS SDK for Goを利用</li><li>フロントはReactを利用</li></ul>※dynamoDBの基本的な動作の説明はございません。※とりあえずロジック考えて動けば良いかなで実装したので絶対もっと良い方法があるはずな気はしています<h2 id="he6c8d05d55">何が大変だったのか</h2>結論から言うと、DynamoDBがこういう検索の仕方を想定していないせいです。(多分)DynamoDBには一応ページネーション的な機能はあるのですが、<a href="https://docs.aws.amazon.com/ja_jp/amazondynamodb/latest/developerguide/Query.Pagination.html" target="_blank" rel="noopener noreferrer nofollow">テーブルクエリ結果をページ分割する</a>これはあくまでDynamoDBが一度に取得できる1MBサイズの縛りを超えて全ての件数を**1回のコールで**取得したいときの実例です。(この縛りもDynamoDBの罠な気がする)利用方法としては、取得したい個数を`Limit`で指定できるので、これを指定し、`LastEvaluatedKey`に取得したいアイテムの1つ前のアイテムを指定するという方法です。さらにフロントからは、<ul><li>全件取得で件数を取得</li><li>6で割ってページネーションが全体で何ページになるか計算</li><li>現在のページをstateで管理</li><li>全件取得したアイテムを6こずつ区切った配列を用意</li><li>現在のページから考えて、上記の区切った配列の最後の要素のidをGetAPIのクエリに混ぜて新しい6個を取得</li></ul>という面倒なことをやらなければなりません。<a href="https://note.com/ryoppei/n/n2c381f434069" target="_blank" rel="noopener noreferrer nofollow">参考リンク</a><h2 id="h59f744c0be">実際のコード</h2><a href="https://github.com/s-amano/unknown-diary/blob/9d86699b71f68d53c8d9a284f719648b30f28fa3/backend/comconfirm-lambda/functions/diary-my-getter/domain/get-my-diary.go#L112" target="_blank" rel="noopener noreferrer nofollow">自分のプロダクトにおける使い方バックエンド</a><a href="https://github.com/s-amano/unknown-diary/blob/9d86699b71f68d53c8d9a284f719648b30f28fa3/React/unknwon-react-diary/src/component/FetchMyDiaries.js#L75" target="_blank" rel="noopener noreferrer nofollow">自分のプロダクトにおける使い方フロントエンド</a>以下はバックエンド側のサンプルですが、割と端折ってます。詳細は上記のソースコードを読んでみてください。詳細は<a href="https://docs.aws.amazon.com/sdk-for-go/api/service/dynamodb/#QueryInput" target="_blank" rel="noopener noreferrer nofollow">公式ドキュメント</a>を参考にしてください。まずクエリで送られてきたidをもとに該当idのアイテムを取得しておく。(itemとする)6個取得したいとき<pre><code>type QueryInput struct {
 ...
 Limit *int64 `min:&quot;1&quot; type:&quot;integer&quot;`
 ExclusiveStartKey map[string]*AttributeValue `type:&quot;map&quot;`
}
// ExclusiveStartKeyに取得したいアイテムの1つ前のアイテムのidなどの項目を指定する
//　フロントから取得したいアイテムの1つ前のidを送ってもらう
// 取得しておいたitemからexclusiveStartKeyを作る

exclusiveStartKey = map[string]*dynamodb.AttributeValue{
 &quot;id&quot;: {
  S: aws.String(*item[&quot;id&quot;].S),
  },
 &quot;post_at&quot;: {
  N: aws.String(*item[&quot;post_at&quot;].N),
  },
}
</code></pre>ここでの注意点は、グローバルインデックスで検索をかけている場合は、この指定するExclusiveStartKeyもパーティションキーとソートキーだけでなく、そちらのキーたちも必要になります。

DynamoDBのwebでのページネーションが苦行だったメモ

<h2 id="he2485005d0">目的</h2>APIの処理をAPIを叩いてきたユーザー名によって変えたいということがありました。そこで、Cognitoでオーソライズを行っているLambda関数にて、API Gatewayの認証情報をLambda(Golang)の中で取得する方法を調べました。<h2 id="hcb9dacb773">結論</h2>以下のコードでユーザー名を取得できます。<pre><code class="language-go">func handler(ctx context.Context, apiGWEvent events.APIGatewayProxyRequest) (events.APIGatewayProxyResponse, error) {

	ユーザー名取得
	diaryGetter := apiGWEvent.RequestContext.Authorizer[&quot;claims&quot;].(map[string]interface{})[&quot;cognito:username&quot;].(string)

  /// ...略
}
</code></pre>割と途中のコードとかが謎ですので、以下に解説を載せておきます。(これより単純に取得できる方法がありましたらご教授いただけると幸いです。)<h2 id="hc499e4ad38">解説</h2>(前提として、LambdaのオーソライザーにCognitoのユーザープールが設定されていることを確認)まず、events.APIGatewayProxyRequestにはどのようなhttpリクエストを受け取ったのかが格納されます。ドキュメントを参照すると、<pre><code class="language-go">type APIGatewayProxyRequest struct {
  Resource            string            `json:&quot;resource&quot;` // The resource path defined in API Gateway
  Path              string            `json:&quot;path&quot;`   // The url path for the caller
  HTTPMethod           string            `json:&quot;httpMethod&quot;`
  Headers             map[string]string       `json:&quot;headers&quot;`
  MultiValueHeaders        map[string][]string      `json:&quot;multiValueHeaders&quot;`
  QueryStringParameters      map[string]string       `json:&quot;queryStringParameters&quot;`
  MultiValueQueryStringParameters map[string][]string      `json:&quot;multiValueQueryStringParameters&quot;`
  PathParameters         map[string]string       `json:&quot;pathParameters&quot;`
  StageVariables         map[string]string       `json:&quot;stageVariables&quot;`
  RequestContext         APIGatewayProxyRequestContext `json:&quot;requestContext&quot;`
  Body              string            `json:&quot;body&quot;`
  IsBase64Encoded         bool             `json:&quot;isBase64Encoded,omitempty&quot;`
}
</code></pre>となっております。参考:[<a href="https://qiita.com/saki-engineering/items/e5cf56301d94ceea3ce0" target="_blank" rel="noopener noreferrer nofollow">GoDoc package aws/aws-lambda-go/events</a>]参考:[<a href="https://qiita.com/saki-engineering/items/e5cf56301d94ceea3ce0" target="_blank" rel="noopener noreferrer nofollow">AWS Lambda+API Gateway+DynamoDBでCRUD APIを作るのをGolangでやってみた</a>]こちらの、RequestContext構造体には、Authorizer情報が`map[string]interface{}`型で入っています。僕が作成したアプリのdev環境用のCognitoの情報を取得してみると、以下の様になっています。<pre><code class="language-go">map[claims:map[aud:tekitoutekitou auth_time:12345678 cognito:username:テスト太郎 event_id:tekitou-d37c-41c9-be67-tekitou exp:Tue May 11 14:18:46 UTC 2021 iat:Tue May 11 13:18:46 UTC 2021 iss:https://cognito-idp.ap-northeast-1.amazonaws.com/ap-northeast-tekitou sub:tekitou-c7e9-4649-ab16-tekitou token_use:id]]
</code></pre>こちらから、claimsキーの中の、cognito:usernameキーがユーザーネームであることがわかります。最初この構造を見たとき、<pre><code class="language-go">diaryGetter := apiGWEvent.RequestContext.Authorizer[&quot;claims&quot;][&quot;cognito:username&quot;]
</code></pre>みたいな感じでとれるんじゃないの？と思ったのですが、これをやろうとすると、<pre><code>invalid operation: cannot index apiGWEvent.RequestContext.Authorizer[&quot;claims&quot;] (map index expression of type interface{})
</code></pre>となってしまいます。interface型の知識が欠如しておりました。&gt; どんな型の値でも受け取れるinterface{}ですが、interface{}型の引数で受け渡された値は、元の型の情報が欠落しています。（元の型の値を操作するための関数等を実行できません）引用:<a href="https://blog.y-yuki.net/entry/2017/05/08/000000">https://blog.y-yuki.net/entry/2017/05/08/000000</a>元の型の値を操作できないため、辞書型のキーを取り出すという動作ができないっぽいです。なので、型アサーションをして、取り出す必要がありました。さらにこの`diaryGetter`はstring型として扱いたいので、最後も型アサーションをする必要があったということです。まず、<pre><code class="language-go">apiGWEvent.RequestContext.Authorizer[&quot;claims&quot;]
</code></pre>を型アサーションで`map[string]interface{}`型にして、mapのキーを取り出すという感じです。