product

type Component struct {
	Name    string `yaml:"-"`
	Version string `yaml:"version"`

	// Group can be used to group by components.
	Group string `yaml:"group"`

	// If RoleName is empty, it will be set to component Name.
	RoleName string `yaml:"roleName"`

	// Form represents the installation method of this component, valid values:
	//  * server
	//  * pod
	// (组件的部署形态)
	Form string `yaml:"form"`

	// Pkgs hold all files that are used to complete the deployment of the component.
	Pkgs []Pkg `yaml:"pkgs"`

	// Enabled represents whether this component will be deployed in the specific environment.
	Enabled bool `yaml:"enabled"`

	// External represents whether this component is provided by external system like cloud, and thus no need to be deployed.
	External bool `yaml:"external"`

	// Services holds all exposed service of the component.
	// Each service is exposed by a specific port.
	Services map[string]Service `yaml:"services"`

	// Computed holds all auto computed service info.
	// This field SHOULD NEVER be edited or changed by operators.
	// The field is always automaticllay computed based on other fields of Component.
	Computed map[string]ServiceComputed `yaml:"computed"`

	// Requires represents the other components on which this component depends on.
	// If this component is activated (enabled:true or external:true), then all these required components also need to be activated.
	// 依赖的服务（其它组件提供的服务，不能依赖自身组件）
	// Todo, check cycle
	Requires []Require `yaml:"requires"`

	// The list value of `deps` represents the other services which depend on this service.
	// If the number of hosts of this service changed, it required that
	// those services who depend on it also need to be reconfigured or restarted.
	// For `service-scaleup` and `service-scaledown`, these dependencies will be used
	Dependencies []string `yaml:"dependencies"`

	// Children represents some children-level components of this component.
	// The children components have the following characteristics:
	// * They can declared to be activated or not enabled: true or false.
	// * They can be upgraded like normal components.
	// * They DO NOT have their own hosts group in ansible inventory, they share the hosts group of its parent component.
	Children []string `yaml:"children"`

	// Applied roles for this component.
	// The empty list will apply at least one role with the component's RoleName.
	Roles []string `yaml:"roles"`

	Vars map[string]interface{} `yaml:"vars"`
	Tags map[string]interface{} `yaml:"tags"`
}

type FilterOption func(c *Component) bool

type Pkg struct {
	File *string `yaml:"file"`
	URL  *string `yaml:"url"`
}

type Product struct {
	Name string `json:"Name,omitempty"  yaml:"Name,omitempty"`

	// zone specific vars of product
	Vars map[string]interface{} `json:"Vars,omitempty" yaml:"Vars,omitempty"`
	// zone specific components of product
	Components map[string]*Component `json:"Components,omitempty" yaml:"Components,omitempty"`

	// default vars of product, it is loaded from products/<productName>/vars.yaml
	DefaultVars map[string]interface{}
	// default components of product, it is loaded from products/<productName>/{components.yaml,components/*.yaml}
	DefaultComponents map[string]Component

	Dir string

	RolesDir string
	// contains filtered or unexported fields
}

type Require struct {
	Component *string `yaml:"component,omitempty"`
	Service   *string `yaml:"service,omitempty"`
}

type Role struct {
}

type Service struct {
	ComponentName string `yaml:"-"`
	Name          string `yaml:"-"`

	Scheme string `yaml:"scheme"`

	// Host, IPv4, IPv6 does not means where the component installed.
	// Host can be domain name or ip address
	Host string `yaml:"host"`
	IPv4 string `yaml:"ipv4"`
	IPv6 string `yaml:"ipv6"`

	// The port should be set to the actual port on which the process listend,
	// thus ansible playbook can use this variable to render configuration files.
	Port int `yaml:"port"`

	Addr string `yaml:"addr"`
	Path string `yaml:"path"`

	Addrs     []string `yaml:"addrs"`
	Endpoints []string `yaml:"endpoints"`
	URLs      []string `yaml:"urls"`

	PubPort int `yaml:"pubPort"`
	LBPort  int `yaml:"lbPort"`
}

type ServiceComputed struct {
	Scheme    string   `yaml:"scheme"`
	Host      string   `yaml:"host"`
	Port      int      `yaml:"port"`
	Addr      string   `yaml:"addr"`
	Path      string   `yaml:"path"`
	Hosts     []string `yaml:"hosts"`
	Addrs     []string `yaml:"addrs"`
	Endpoints []string `yaml:"endpoints"`
	URLs      []string `yaml:"urls"`
}