mirror of
https://github.com/etcd-io/etcd.git
synced 2024-09-27 06:25:44 +00:00

This commit makes the rarely used `raftpb.Message.Snapshot` field nullable. In doing so, it reduces the memory size of a `raftpb.Message` message from 264 bytes to 128 bytes — a 52% reduction in size. While this commit does not change the protobuf encoding, it does change how that encoding is used. `(gogoproto.nullable) = false` instruct the generated proto marshaling logic to always encode a value for the field, even if that value is empty. `(gogoproto.nullable) = true` instructs the generated proto marshaling logic to omit an encoded value for the field if the field is nil. This raises compatibility concerns in both directions. Messages encoded by new binary versions without a `Snapshot` field will be decoded as an empty field by old binary versions. In other words, old binary versions can't tell the difference. However, messages encoded by old binary versions with an empty Snapshot field will be decoded as a non-nil, empty field by new binary versions. As a result, new binary versions need to be prepared to handle such messages. While Message.Snapshot is not intentionally part of the external interface of this library, it was possible for users of the library to access it and manipulate it. As such, this change may be considered a breaking change. Signed-off-by: Nathan VanBenschoten <nvanbenschoten@gmail.com>
142 lines
3.5 KiB
Go
142 lines
3.5 KiB
Go
// Copyright 2016 The etcd Authors
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
package rafthttp
|
|
|
|
import (
|
|
"fmt"
|
|
"io"
|
|
"net/http"
|
|
"net/http/httptest"
|
|
"os"
|
|
"strings"
|
|
"testing"
|
|
"time"
|
|
|
|
"go.etcd.io/etcd/client/pkg/v3/types"
|
|
"go.etcd.io/etcd/raft/v3/raftpb"
|
|
"go.etcd.io/etcd/server/v3/etcdserver/api/snap"
|
|
"go.uber.org/zap/zaptest"
|
|
)
|
|
|
|
type strReaderCloser struct{ *strings.Reader }
|
|
|
|
func (s strReaderCloser) Close() error { return nil }
|
|
|
|
func TestSnapshotSend(t *testing.T) {
|
|
tests := []struct {
|
|
m raftpb.Message
|
|
rc io.ReadCloser
|
|
size int64
|
|
|
|
wsent bool
|
|
wfiles int
|
|
}{
|
|
// sent and receive with no errors
|
|
{
|
|
m: raftpb.Message{Type: raftpb.MsgSnap, To: 1, Snapshot: &raftpb.Snapshot{}},
|
|
rc: strReaderCloser{strings.NewReader("hello")},
|
|
size: 5,
|
|
|
|
wsent: true,
|
|
wfiles: 1,
|
|
},
|
|
// error when reading snapshot for send
|
|
{
|
|
m: raftpb.Message{Type: raftpb.MsgSnap, To: 1, Snapshot: &raftpb.Snapshot{}},
|
|
rc: &errReadCloser{fmt.Errorf("snapshot error")},
|
|
size: 1,
|
|
|
|
wsent: false,
|
|
wfiles: 0,
|
|
},
|
|
// sends less than the given snapshot length
|
|
{
|
|
m: raftpb.Message{Type: raftpb.MsgSnap, To: 1, Snapshot: &raftpb.Snapshot{}},
|
|
rc: strReaderCloser{strings.NewReader("hello")},
|
|
size: 10000,
|
|
|
|
wsent: false,
|
|
wfiles: 0,
|
|
},
|
|
// sends less than actual snapshot length
|
|
{
|
|
m: raftpb.Message{Type: raftpb.MsgSnap, To: 1, Snapshot: &raftpb.Snapshot{}},
|
|
rc: strReaderCloser{strings.NewReader("hello")},
|
|
size: 1,
|
|
|
|
wsent: false,
|
|
wfiles: 0,
|
|
},
|
|
}
|
|
|
|
for i, tt := range tests {
|
|
sent, files := testSnapshotSend(t, snap.NewMessage(tt.m, tt.rc, tt.size))
|
|
if tt.wsent != sent {
|
|
t.Errorf("#%d: snapshot expected %v, got %v", i, tt.wsent, sent)
|
|
}
|
|
if tt.wfiles != len(files) {
|
|
t.Fatalf("#%d: expected %d files, got %d files", i, tt.wfiles, len(files))
|
|
}
|
|
}
|
|
}
|
|
|
|
func testSnapshotSend(t *testing.T, sm *snap.Message) (bool, []os.DirEntry) {
|
|
d := t.TempDir()
|
|
|
|
r := &fakeRaft{}
|
|
tr := &Transport{pipelineRt: &http.Transport{}, ClusterID: types.ID(1), Raft: r}
|
|
ch := make(chan struct{}, 1)
|
|
h := &syncHandler{newSnapshotHandler(tr, r, snap.New(zaptest.NewLogger(t), d), types.ID(1)), ch}
|
|
srv := httptest.NewServer(h)
|
|
defer srv.Close()
|
|
|
|
picker := mustNewURLPicker(t, []string{srv.URL})
|
|
snapsend := newSnapshotSender(tr, picker, types.ID(1), newPeerStatus(zaptest.NewLogger(t), types.ID(0), types.ID(1)))
|
|
defer snapsend.stop()
|
|
|
|
snapsend.send(*sm)
|
|
|
|
sent := false
|
|
select {
|
|
case <-time.After(time.Second):
|
|
t.Fatalf("timed out sending snapshot")
|
|
case sent = <-sm.CloseNotify():
|
|
}
|
|
|
|
// wait for handler to finish accepting snapshot
|
|
<-ch
|
|
|
|
files, rerr := os.ReadDir(d)
|
|
if rerr != nil {
|
|
t.Fatal(rerr)
|
|
}
|
|
return sent, files
|
|
}
|
|
|
|
type errReadCloser struct{ err error }
|
|
|
|
func (s *errReadCloser) Read(p []byte) (int, error) { return 0, s.err }
|
|
func (s *errReadCloser) Close() error { return s.err }
|
|
|
|
type syncHandler struct {
|
|
h http.Handler
|
|
ch chan<- struct{}
|
|
}
|
|
|
|
func (sh *syncHandler) ServeHTTP(w http.ResponseWriter, r *http.Request) {
|
|
sh.h.ServeHTTP(w, r)
|
|
sh.ch <- struct{}{}
|
|
}
|