AWSのAPIを使うときに気をつけてること

Transcript

1. AWSのAPIを使うときに 気をつけていること JAWS-­‐UG  Osaka  第13回勉強会   柳柳瀬  任章
2. 柳柳瀬  任章（やなせ  ひであき） ⾃自⼰己紹介 @oko_chang   h6ps://www.facebook.com/yanase.hideaki   h6p://okochang.hatenablog.jp   h6p://cloudautomator.com
3. • AWSの運⽤用を⾃自動化するサービスです   • 様々なトリガーをきっかけに、お客様のAWSリソースを⾃自動 的に操作することで、⼈人⼿手に頼らない、品質の⾼高い運⽤用を実 現します Cloud  Automatorとは
4. Cloud  Automatorで出来ること • トリガーとアクションを組み合わせることで以下のような運 ⽤用を⾃自動化出来ます
5. JAWS-‐‑‒UG  KANSAI特別編のおさらい
6. 酒飲んだ、 財布無くした、 気をつけよう。 Andrew_̲mc_̲d
7. 今回のテーマ
8. AWSのAPIを使うときに 気をつけていること hackNY.org
9. 『⾃自分でスクリプト書けるし、困ってないよねー。』   『AWSと⾔言ったらAPI使わないとね〜～！』 Cloud  Automator加⼊入前のわたし
10. ごめんなさい eesti
11. ご経験ありますでしょうか？
12. そんなスクリプトで⼤大丈夫か？
13. ある⽇日スクリプトが動かなかったが、原因わからず   その１
14. ログ出⼒力力をしよう１ 0 4 * * * /home/foo/backup.sh > /home/foo/log/script.log 2>&1
15. ログ出⼒力力をしよう２ require ‘logger’ logger = Logger.new(‘script.log’) logger.level = Logger::ERROR || Logger::INFO logger.formatter = Logger::Forrmatter.new logger.error(“sample error message”)
16. エラー処理理は何処へ    その２
17. エラー処理理例例 #!/bin/bash trap ‘echo “backup failed $BASH_COMMAND” ; exit 1’ERR aws ec2 create-images --instance i-xxxxxxxx --name backup-ami echo backup succeeded exit 0
18. エラー処理理例例 def sample(region, instance_id, name, desc) @ec2 = Aws::EC2::Resource.new(region: region) @logger = Logger.new(‘script.log’) begin @ec2.instance(instance_id).create_image( name: name, description: desc ) rescue => e @logger.error { e } end end
19. エラー発⽣生時はすべて同じ処理理    その３
20. 認証、権限 • Aws::EC2::Errors::AuthFailure   • Aws::EC2::Errors::UnauthorizedOperaOon   • Aws::RDS::Errors::InvalidClientToken   • Aws::RDS::Errors::SignatureDoesNotMatch   • Aws::RDS::Errors::AccessDenied  
21. パラメーター • Aws::EC2::Errors::InvalidParameterValue   • Aws::EC2::Errors::InvalidParameterCombinaOon   • Aws::RDS::Errors::InvalidParameterValue   • Aws::RDS::Errors::InvalidParameterCombinaOon    
22. サービスリミット • Aws::EC2::Errors::InstanceLimitExceeded   • Aws::EC2::Errors::SnapshotLimitExceeded   • Aws::EC2::Errors::ResourceLimitExceeded  
23. リクエスト過多 • Aws::EC2::Errors::Thro6ling   • Aws::RDS::Errors::Thro6ling  
24. エラー別に処理理をわける def sample(region, instance_id, name, desc) @ec2 = Aws::EC2::Resource.new(region: region) begin @ec2.instance(instance_id).create_image(name: name, description: desc) rescue USER_EXCEPTIONS => e # エラー処理理    rescue SYSTEM_EXCEPTIONS => e # エラー処理理 rescue => e # エラー処理理 end end
25. エラーになったら諦めちゃう    その４
26. AWS  SDK  for  Ruby  +  2.0でのリトライ require ‘aws-sdk’ @ec2 = Aws::EC2::Resource.new( region: region, retry_limit: 10 )
27. AWS  SDK  for  Ruby  v1でのリトライ require ‘aws-sdk’ @ec2 = AWS::EC2.new( region: region, max_retries: 10 )
28. Retriable • ExponenOal  backoffとリトライ処理理を簡単に実装出来る   • h6p://jackchu.com/retriable/   • Ruby  2.0+   $ gem install retriable
29. 使い⽅方 require ‘retriable’ class retry def peform Retriable.retriable do # 処理理を書く end end end
30. リトライした例例 def sample(region, instance_id, name, desc) @ec2 = Aws::EC2::Resource.new(region: region) begin Retriable.retriable on: RETRY_EXCEPTIONS do  @ec2.instance(instance_id).create_image(name: name, description: desc) # その他リトライしたい処理理 end rescue USER_EXCEPTIONS => e # エラー処理理    rescue => e # エラー処理理 end end
31. その他の⾔言語で • Python   •  retrying   •  h6ps://pypi.python.org/pypi/retrying   •  Go⾔言語   •  backoff   •  h6ps://github.com/cenkalO/backoff  
32. まとめ • 丁寧に実装すると、スクリプトの信頼性があがりますね  
33. 参考 •  h6p://jarp.does.notwork.org/diary/201210b.html#20121014   •  h6p://docs.aws.amazon.com/AWSEC2/latest/APIReference/errors-­‐ overview.html   •  h6p://docs.aws.amazon.com/AmazonRDS/latest/APIReference/ CommonErrors.html   •  h6p://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html   •  h6p://docs.aws.amazon.com/sdkforruby/api/Aws/EC2/Client.html   •  h6p://docs.aws.amazon.com/AWSRubySDK/latest/AWS/Core/ ConfiguraOon.html#max_retries-­‐instance_method   •  h6ps://pypi.python.org/pypi/retrying   •  h6ps://github.com/cenkalO/backoff  
34. 募集しています！ h6ps://www.wantedly.com/companies/serverworks/projects  
35. 飲み過ぎ注意 Andrew_̲mc_̲d