Kubernetes Visitor設計模式及傳送pod建立請求解析

// Visitor 即為存取者這個物件
type Visitor interface {
	Visit(VisitorFunc) error
}
// VisitorFunc對應這個物件的方法，也就是定義中的「操作」
type VisitorFunc func(*Info, error) error

// VisitorList定義為[]Visitor，又實現了Visit方法，也就是將多個[]Visitor封裝為一個Visitor
type VisitorList []Visitor
// 發生error就立刻返回，不繼續遍歷
func (l VisitorList) Visit(fn VisitorFunc) error {
	for i := range l {
		if err := l[i].Visit(fn); err != nil {
			return err
		}
	}
	return nil
}

// EagerVisitorList 也是將多個[]Visitor封裝為一個Visitor
type EagerVisitorList []Visitor
// 返回的錯誤暫存到[]error中，統一聚合
func (l EagerVisitorList) Visit(fn VisitorFunc) error {
	errs := []error(nil)
	for i := range l {
		if err := l[i].Visit(func(info *Info, err error) error {
			if err != nil {
				errs = append(errs, err)
				return nil
			}
			if err := fn(info, nil); err != nil {
				errs = append(errs, err)
			}
			return nil
		}); err != nil {
			errs = append(errs, err)
		}
	}
	return utilerrors.NewAggregate(errs)
}

// 裝飾器Visitor
type DecoratedVisitor struct {
	visitor    Visitor
	decorators []VisitorFunc
}
// visitor遍歷呼叫decorators中所有函數，有失敗立即返回
func (v DecoratedVisitor) Visit(fn VisitorFunc) error {
	return v.visitor.Visit(func(info *Info, err error) error {
		if err != nil {
			return err
		}
		for i := range v.decorators {
			if err := v.decorators[i](info, nil); err != nil {
				return err
			}
		}
		return fn(info, nil)
	})
}

// 報錯依舊繼續
type ContinueOnErrorVisitor struct {
	Visitor
}
// 報錯不立即返回，聚合所有錯誤後返回
func (v ContinueOnErrorVisitor) Visit(fn VisitorFunc) error {
	errs := []error{}
	err := v.Visitor.Visit(func(info *Info, err error) error {
		if err != nil {
			errs = append(errs, err)
			return nil
		}
		if err := fn(info, nil); err != nil {
			errs = append(errs, err)
		}
		return nil
	})
	if err != nil {
		errs = append(errs, err)
	}
	if len(errs) == 1 {
		return errs[0]
	}
	return utilerrors.NewAggregate(errs)
}

type FlattenListVisitor struct {
	visitor Visitor
	typer   runtime.ObjectTyper
	mapper  *mapper
}

// 過濾的Info
type FilteredVisitor struct {
	visitor Visitor
	filters []FilterFunc
}
func (v FilteredVisitor) Visit(fn VisitorFunc) error {
	return v.visitor.Visit(func(info *Info, err error) error {
		if err != nil {
			return err
		}
		for _, filter := range v.filters {
      // 檢驗Info是否滿足條件，出錯則退出
			ok, err := filter(info, nil)
			if err != nil {
				return err
			}
			if !ok {
				return nil
			}
		}
		return fn(info, nil)
	})
}

type StreamVisitor struct {
  // 讀取資訊的來源，實現了Read這個介面，這個"流式"的概念，包括了常見的HTTP、檔案、標準輸入等各類輸入
	io.Reader
	*mapper
	Source string
	Schema ContentValidator
}

type FileVisitor struct {
  // 表示檔案路徑或者STDIN
	Path string
	*StreamVisitor
}

type URLVisitor struct {
	URL *url.URL
	*StreamVisitor
  // 提供錯誤重試次數
	HttpAttemptCount int
}

type KustomizeVisitor struct {
	Path string
	*StreamVisitor
}

// 在RunCreate函數中，關鍵的傳送函數
obj, err := resource.
				NewHelper(info.Client, info.Mapping).
				DryRun(o.DryRunStrategy == cmdutil.DryRunServer).
				WithFieldManager(o.fieldManager).
				Create(info.Namespace, true, info.Object)
// 進入create函數，檢視到
m.createResource(m.RESTClient, m.Resource, namespace, obj, options)
// 對應的實現為
func (m *Helper) createResource(c RESTClient, resource, namespace string, obj runtime.Object, options *metav1.CreateOptions) (runtime.Object, error) {
	return c.Post().
		NamespaceIfScoped(namespace, m.NamespaceScoped).
		Resource(resource).
		VersionedParams(options, metav1.ParameterCodec).
		Body(obj).
		Do(context.TODO()).
		Get()
}
/*
到這裡，我們發現了2個關鍵性的定義:
1. RESTClient 與kube-apiserver互動的RESTful風格的使用者端 這個RESTClient是來自於Builder時的傳入，生成的Result，底層是一個NewClientWithOptions生成的
2. runtime.Object 資源物件的抽象，包括Pod/Deployment/Service等各類資源
3. 我們是傳入的檔案，是FileVisitor來執行的，底層Builder.mapper呼叫Decode來生成obj(Unstructured())
*/

// 從傳入引數來看，資料來源於Info這個結構
r.Visit(func(info *resource.Info, err error) error{})
// 而info來源於前面的Builder，前面部分都是將Builder引數化，核心的生成為Do函數
r := f.NewBuilder().
		Unstructured().
		Schema(schema).
		ContinueOnError().
		NamespaceParam(cmdNamespace).DefaultNamespace().
		FilenameParam(enforceNamespace, &o.FilenameOptions).
		LabelSelectorParam(o.Selector).
		Flatten().
		Do()
// 大致看一下這些函數，我們可以在Unstructured()中看到getClient函數，其實這就是我們要找的函數
func (b *Builder) getClient(gv schema.GroupVersion) (RESTClient, error) 
// 從返回值來看，client包括預設的REST client和設定選項
NewClientWithOptions(client, b.requestTransforms...)
// 這個Client會在kubernetes專案中大量出現，它是與kube-apiserver互動的核心元件，以後再深入。

func (v *FileVisitor) Visit(fn VisitorFunc) error {
	// 省略讀取這塊的程式碼，底層呼叫的是StreamVisitor的邏輯
	return v.StreamVisitor.Visit(fn)
}
func (v *StreamVisitor) Visit(fn VisitorFunc) error {
	d := yaml.NewYAMLOrJSONDecoder(v.Reader, 4096)
	for {
		// 這裡就是返回info的地方
		info, err := v.infoForData(ext.Raw, v.Source)
  }
}
// 再往下一層看，來到mapper層，也就是kubernetes的資源物件對映關係
func (m *mapper) infoForData(data []byte, source string) (*Info, error){
  // 這裡就是我們返回Object的地方，其中GVK是Group/Version/Kind的縮寫，後續我們會涉及
  obj, gvk, err := m.decoder.Decode(data, nil, nil)
}

// 在Builder初始化中，我們就找到了
func (b *Builder) Unstructured() *Builder {
	b.mapper = &mapper{
		localFn:      b.isLocal,
		restMapperFn: b.restMapperFn,
		clientFn:     b.getClient,
    // 我們查詢資源用到的是這個decoder
		decoder:      &metadataValidatingDecoder{unstructured.UnstructuredJSONScheme},
	}
	return b
}
// 逐層往下找，對應的Decode方法的實現，就是對應的資料解析成data：
func (s unstructuredJSONScheme) decode(data []byte) (runtime.Object, error) {
	// 細節暫時忽略
}

// RESTful介面風格中，POST請求對應的就是CREATE方法
c.Post().
		NamespaceIfScoped(namespace, m.NamespaceScoped).
		Resource(resource).
		VersionedParams(options, metav1.ParameterCodec).
		Body(obj).
		Do(context.TODO()). 
		Get() 
// Do方法，傳送請求
err := r.request(ctx, func(req *http.Request, resp *http.Response) {
		result = r.transformResponse(resp, req)
	})
// Get方法，獲取請求的返回結果，用來列印狀態
switch t := out.(type) {
	case *metav1.Status:
		if t.Status != metav1.StatusSuccess {
			return nil, errors.FromObject(t)
		}
	}