【社内資料公開】運用手順書を作る時のポイントについて書いてみた | DevelopersIO
はじめに こんにちは植木和樹＠上越妙高オフィスです。本日は私がここ10年くらい意識している運用手順書を書くときのポイントについてまとめてみました。 対象読者 開発・構築したシステムを別の人に引き継ぐ予定のある人 他の人が作ったシステムを引き継ぐ担当の人 半年後の自分でも分かる手順書の書き方に困っている人 （この記事を読むのにかかる時間の目安：5分） 1. ドキュメントの冒頭に書くこと まず個々の詳細手順の前に、ドキュメント自体について記載してもらいたいことです。 1.1. ドキュメントに書かれていることを3行で書く ドキュメントの最初には、このドキュメントに何が書かれているのかを100文字くらいで書いておくと良いでしょう。 システムが増えれば増えるほど手順書も増えていくものです。見つけたドキュメントに自分の期待するものが書かれているのか、冒頭数行でわかるようになっているとうれしいです。 1
AWSのリソース構成をServerspecのようにテストする "awspec" をつくった - Copy/Cut/Paste/Hatena
AWSのリソース構成をServerspecのようにテストできる "awspec" をつくりました。 github.com 例えばEC2インスタンスであれば、以下のように書けます。 describe ec2('my-ec2') do it { should exist } it { should be_running } it { should_not be_stopped } its(:instance_id) { should eq 'i-ec12345a' } its(:private_ip_address) { should eq '10.0.1.1' } it { should have_security_group('my-security-group-name') } it { should belong_to_vpc('my-vpc') } it { should belon
AWS SDK for Ruby V2使ってみたけどまだ辛かった - mikedaの日記
そういえばAWS SDK for RubyのV2が出てたけどまだ試してないなぁ、 と思って手元のEC2インスタンス作成スクリプトをV2に書き換えてみたら辛かったです。 V1 Github ドキュメント V2 Gibhub ドキュメント 日本語でのV2の紹介記事はクラスメソッドさんのブログにありました。 v2のコードは、 基本機能が定義されたaws-sdk-core 抽象化されたリソースクラスが定義されたaws-sdk-resources という2つのgemに分かれています。 aws-sdk-coreはstableですが、aws-sdk-resourcesはまだpreviewです。 じゃあまぁ、 aws-sdk-coreだけでどの程度使えるのか aws-sdk-resourcesがどの程度preview版なのか というところが気になるところです。 スクリプト仕様 こんな感じでスクリプトをたた
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
処理を実行中です
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
