github.com/sathish1597/hashicorp-terraform@v0.11.12-beta1/backend/remote-state/etcdv3/client.go (about) 1 package etcd 2 3 import ( 4 "context" 5 "crypto/md5" 6 "encoding/json" 7 "fmt" 8 "sync" 9 "time" 10 11 etcdv3 "github.com/coreos/etcd/clientv3" 12 etcdv3sync "github.com/coreos/etcd/clientv3/concurrency" 13 "github.com/hashicorp/go-multierror" 14 "github.com/hashicorp/terraform/state" 15 "github.com/hashicorp/terraform/state/remote" 16 ) 17 18 const ( 19 lockAcquireTimeout = 2 * time.Second 20 lockInfoSuffix = ".lockinfo" 21 ) 22 23 // RemoteClient is a remote client that will store data in etcd. 24 type RemoteClient struct { 25 Client *etcdv3.Client 26 DoLock bool 27 Key string 28 29 etcdMutex *etcdv3sync.Mutex 30 etcdSession *etcdv3sync.Session 31 info *state.LockInfo 32 mu sync.Mutex 33 modRevision int64 34 } 35 36 func (c *RemoteClient) Get() (*remote.Payload, error) { 37 c.mu.Lock() 38 defer c.mu.Unlock() 39 40 res, err := c.Client.KV.Get(context.TODO(), c.Key) 41 if err != nil { 42 return nil, err 43 } 44 if res.Count == 0 { 45 return nil, nil 46 } 47 if res.Count >= 2 { 48 return nil, fmt.Errorf("Expected a single result but got %d.", res.Count) 49 } 50 51 c.modRevision = res.Kvs[0].ModRevision 52 53 payload := res.Kvs[0].Value 54 md5 := md5.Sum(payload) 55 56 return &remote.Payload{ 57 Data: payload, 58 MD5: md5[:], 59 }, nil 60 } 61 62 func (c *RemoteClient) Put(data []byte) error { 63 c.mu.Lock() 64 defer c.mu.Unlock() 65 66 res, err := etcdv3.NewKV(c.Client).Txn(context.TODO()).If( 67 etcdv3.Compare(etcdv3.ModRevision(c.Key), "=", c.modRevision), 68 ).Then( 69 etcdv3.OpPut(c.Key, string(data)), 70 etcdv3.OpGet(c.Key), 71 ).Commit() 72 73 if err != nil { 74 return err 75 } 76 if !res.Succeeded { 77 return fmt.Errorf("The transaction did not succeed.") 78 } 79 if len(res.Responses) != 2 { 80 return fmt.Errorf("Expected two responses but got %d.", len(res.Responses)) 81 } 82 83 c.modRevision = res.Responses[1].GetResponseRange().Kvs[0].ModRevision 84 return nil 85 } 86 87 func (c *RemoteClient) Delete() error { 88 c.mu.Lock() 89 defer c.mu.Unlock() 90 91 _, err := c.Client.KV.Delete(context.TODO(), c.Key) 92 return err 93 } 94 95 func (c *RemoteClient) Lock(info *state.LockInfo) (string, error) { 96 c.mu.Lock() 97 defer c.mu.Unlock() 98 99 if !c.DoLock { 100 return "", nil 101 } 102 if c.etcdSession != nil { 103 return "", fmt.Errorf("state %q already locked", c.Key) 104 } 105 106 c.info = info 107 return c.lock() 108 } 109 110 func (c *RemoteClient) Unlock(id string) error { 111 c.mu.Lock() 112 defer c.mu.Unlock() 113 114 if !c.DoLock { 115 return nil 116 } 117 118 return c.unlock(id) 119 } 120 121 func (c *RemoteClient) deleteLockInfo(info *state.LockInfo) error { 122 res, err := c.Client.KV.Delete(context.TODO(), c.Key+lockInfoSuffix) 123 if err != nil { 124 return err 125 } 126 if res.Deleted == 0 { 127 return fmt.Errorf("No keys deleted for %s when deleting lock info.", c.Key+lockInfoSuffix) 128 } 129 return nil 130 } 131 132 func (c *RemoteClient) getLockInfo() (*state.LockInfo, error) { 133 res, err := c.Client.KV.Get(context.TODO(), c.Key+lockInfoSuffix) 134 if err != nil { 135 return nil, err 136 } 137 if res.Count == 0 { 138 return nil, nil 139 } 140 141 li := &state.LockInfo{} 142 err = json.Unmarshal(res.Kvs[0].Value, li) 143 if err != nil { 144 return nil, fmt.Errorf("Error unmarshaling lock info: %s.", err) 145 } 146 147 return li, nil 148 } 149 150 func (c *RemoteClient) putLockInfo(info *state.LockInfo) error { 151 c.info.Path = c.etcdMutex.Key() 152 c.info.Created = time.Now().UTC() 153 154 _, err := c.Client.KV.Put(context.TODO(), c.Key+lockInfoSuffix, string(c.info.Marshal())) 155 return err 156 } 157 158 func (c *RemoteClient) lock() (string, error) { 159 session, err := etcdv3sync.NewSession(c.Client) 160 if err != nil { 161 return "", nil 162 } 163 164 ctx, cancel := context.WithTimeout(context.TODO(), lockAcquireTimeout) 165 defer cancel() 166 167 mutex := etcdv3sync.NewMutex(session, c.Key) 168 if err1 := mutex.Lock(ctx); err1 != nil { 169 lockInfo, err2 := c.getLockInfo() 170 if err2 != nil { 171 return "", &state.LockError{Err: err2} 172 } 173 return "", &state.LockError{Info: lockInfo, Err: err1} 174 } 175 176 c.etcdMutex = mutex 177 c.etcdSession = session 178 179 err = c.putLockInfo(c.info) 180 if err != nil { 181 if unlockErr := c.unlock(c.info.ID); unlockErr != nil { 182 err = multierror.Append(err, unlockErr) 183 } 184 return "", err 185 } 186 187 return c.info.ID, nil 188 } 189 190 func (c *RemoteClient) unlock(id string) error { 191 if c.etcdMutex == nil { 192 return nil 193 } 194 195 var errs error 196 197 if err := c.deleteLockInfo(c.info); err != nil { 198 errs = multierror.Append(errs, err) 199 } 200 if err := c.etcdMutex.Unlock(context.TODO()); err != nil { 201 errs = multierror.Append(errs, err) 202 } 203 if err := c.etcdSession.Close(); err != nil { 204 errs = multierror.Append(errs, err) 205 } 206 207 c.etcdMutex = nil 208 c.etcdSession = nil 209 210 return errs 211 }