Merge pull request #42787 from thaJeztah/libnetwork_fix_lint

libnetwork: fix some linting issues
This commit is contained in:
Sebastiaan van Stijn 2021-08-28 01:18:13 +02:00 committed by GitHub
commit 7bdf98276c
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 24 additions and 35 deletions

View file

@ -9,10 +9,7 @@ import (
"github.com/docker/docker/pkg/plugingetter"
)
/********************
* IPAM plugin types
********************/
// IPAM plugin types
const (
// DefaultIPAM is the name of the built-in default ipam driver
DefaultIPAM = "default"
@ -34,10 +31,6 @@ type Callback interface {
RegisterIpamDriverWithCapabilities(name string, driver Ipam, capability *Capability) error
}
/**************
* IPAM Errors
**************/
// Well-known errors returned by IPAM
var (
ErrIpamInternalError = types.InternalErrorf("IPAM Internal Error")
@ -56,10 +49,6 @@ var (
ErrBadPool = types.BadRequestErrorf("Address space does not contain specified address pool")
)
/*******************************
* IPAM Service Interface
*******************************/
// Ipam represents the interface the IPAM service plugins must implement
// in order to allow injection/modification of IPAM database.
type Ipam interface {
@ -76,12 +65,12 @@ type Ipam interface {
RequestPool(addressSpace, pool, subPool string, options map[string]string, v6 bool) (string, *net.IPNet, map[string]string, error)
// ReleasePool releases the address pool identified by the passed id
ReleasePool(poolID string) error
// Request address from the specified pool ID. Input options or required IP can be passed.
// RequestAddress request an address from the specified pool ID. Input options or required IP can be passed.
RequestAddress(string, net.IP, map[string]string) (*net.IPNet, map[string]string, error)
// Release the address from the specified pool ID
// ReleaseAddress releases the address from the specified pool ID.
ReleaseAddress(string, net.IP) error
//IsBuiltIn returns true if it is a built-in driver.
// IsBuiltIn returns true if it is a built-in driver.
IsBuiltIn() bool
}

View file

@ -26,16 +26,16 @@ import (
// A Network represents a logical connectivity zone that containers may
// join using the Link method. A Network is managed by a specific driver.
type Network interface {
// A user chosen name for this network.
// Name returns a user chosen name for this network.
Name() string
// A system generated id for this network.
// ID returns a system generated id for this network.
ID() string
// The type of network, which corresponds to its managing driver.
// Type returns the type of network, which corresponds to its managing driver.
Type() string
// Create a new endpoint to this network symbolically identified by the
// CreateEndpoint creates a new endpoint to this network symbolically identified by the
// specified unique name. The options parameter carries driver specific options.
CreateEndpoint(name string, options ...EndpointOption) (Endpoint, error)
@ -45,7 +45,7 @@ type Network interface {
// Endpoints returns the list of Endpoint(s) in this network.
Endpoints() []Endpoint
// WalkEndpoints uses the provided function to walk the Endpoints
// WalkEndpoints uses the provided function to walk the Endpoints.
WalkEndpoints(walker EndpointWalker)
// EndpointByName returns the Endpoint which has the passed name. If not found, the error ErrNoSuchEndpoint is returned.
@ -54,7 +54,7 @@ type Network interface {
// EndpointByID returns the Endpoint which has the passed id. If not found, the error ErrNoSuchEndpoint is returned.
EndpointByID(id string) (Endpoint, error)
// Return certain operational data belonging to this network
// Info returns certain operational data belonging to this network.
Info() NetworkInfo
}
@ -78,8 +78,8 @@ type NetworkInfo interface {
// gossip cluster. For non-dynamic overlay networks and bridge networks it returns an
// empty slice
Peers() []networkdb.PeerInfo
//Services returns a map of services keyed by the service name with the details
//of all the tasks that belong to the service. Applicable only in swarm mode.
// Services returns a map of services keyed by the service name with the details
// of all the tasks that belong to the service. Applicable only in swarm mode.
Services() map[string]ServiceInfo
}
@ -89,7 +89,7 @@ type EndpointWalker func(ep Endpoint) bool
// ipInfo is the reverse mapping from IP to service name to serve the PTR query.
// extResolver is set if an external server resolves a service name to this IP.
// Its an indication to defer PTR queries also to that external server.
// It's an indication to defer PTR queries also to that external server.
type ipInfo struct {
name string
serviceID string
@ -130,15 +130,15 @@ type networkDBTable struct {
// IpamConf contains all the ipam related configurations for a network
type IpamConf struct {
// The master address pool for containers and network interfaces
// PreferredPool is the master address pool for containers and network interfaces.
PreferredPool string
// A subset of the master pool. If specified,
// this becomes the container pool
// SubPool is a subset of the master pool. If specified,
// this becomes the container pool.
SubPool string
// Preferred Network Gateway address (optional)
// Gateway is the preferred Network Gateway address (optional).
Gateway string
// Auxiliary addresses for network driver. Must be within the master pool.
// libnetwork will reserve them if they fall into the container pool
// AuxAddresses contains auxiliary addresses for network driver. Must be within the master pool.
// libnetwork will reserve them if they fall into the container pool.
AuxAddresses map[string]string
}
@ -415,7 +415,7 @@ func (n *network) validateConfiguration() error {
return nil
}
// Applies network specific configurations
// applyConfigurationTo applies network specific configurations.
func (n *network) applyConfigurationTo(to *network) error {
to.enableIPv6 = n.enableIPv6
if len(n.labels) > 0 {
@ -1197,12 +1197,12 @@ func (n *network) createEndpoint(name string, options ...EndpointOption) (Endpoi
}
}
ipam, cap, err := n.getController().getIPAMDriver(n.ipamType)
ipam, capability, err := n.getController().getIPAMDriver(n.ipamType)
if err != nil {
return nil, err
}
if cap.RequiresMACAddress {
if capability.RequiresMACAddress {
if ep.iface.mac == nil {
ep.iface.mac = netutils.GenerateRandomMAC()
}
@ -2236,14 +2236,14 @@ func (n *network) deleteLoadBalancerSandbox() error {
if sb != nil {
if err := sb.DisableService(); err != nil {
logrus.Warnf("Failed to disable service on sandbox %s: %v", sandboxName, err)
//Ignore error and attempt to delete the load balancer endpoint
// Ignore error and attempt to delete the load balancer endpoint
}
}
}
if err := endpoint.Delete(true); err != nil {
logrus.Warnf("Failed to delete endpoint %s (%s) in %s: %v", endpoint.Name(), endpoint.ID(), sandboxName, err)
//Ignore error and attempt to delete the sandbox.
// Ignore error and attempt to delete the sandbox.
}
}