Documentation ¶
Index ¶
- Constants
- func CreateDataVolumeFromDefinition(clientSet *cdiclientset.Clientset, namespace string, def *cdiv1.DataVolume) (*cdiv1.DataVolume, error)
- func CreateExecutorPodWithPVC(clientSet *kubernetes.Clientset, podName, namespace string, ...) (*k8sv1.Pod, error)
- func CreatePVCFromDefinition(clientSet *kubernetes.Clientset, namespace string, ...) (*k8sv1.PersistentVolumeClaim, error)
- func CreatePod(clientSet *kubernetes.Clientset, namespace string, podDef *k8sv1.Pod) (*k8sv1.Pod, error)
- func CreateSecretFromDefinition(c *kubernetes.Clientset, secret *v1.Secret) (*v1.Secret, error)
- func DeleteDataVolume(clientSet *cdiclientset.Clientset, namespace string, ...) error
- func DeletePVC(clientSet *kubernetes.Clientset, namespace string, ...) error
- func DeletePod(clientSet *kubernetes.Clientset, pod *k8sv1.Pod, namespace string) error
- func DownloadImageToNode(clientSet *kubernetes.Clientset, cliCommandPath string) error
- func FindPVC(clientSet *kubernetes.Clientset, namespace, pvcName string) (*k8sv1.PersistentVolumeClaim, error)
- func FindPodByPrefix(clientSet *kubernetes.Clientset, namespace, prefix, labelSelector string) (*k8sv1.Pod, error)
- func FormatTestData(srcFile, tgtDir string, targetFormats ...string) (string, error)
- func GetServiceInNamespace(c *kubernetes.Clientset, ns, name string) (*v1.Service, error)
- func GetServiceInNamespaceOrDie(c *kubernetes.Clientset, ns, name string) *v1.Service
- func GetServiceNodePortByName(svc *v1.Service, name string) (int, error)
- func GetServicePortByName(svc *v1.Service, name string) (int, error)
- func GetServicesInNamespaceByLabel(c *kubernetes.Clientset, ns, labelSelector string) (*v1.ServiceList, error)
- func NewDataVolumeWithHttpImport(dataVolumeName string, size string, httpUrl string) *cdiv1.DataVolume
- func NewDataVolumeWithPVCImport(dataVolumeName string, size string, targetPvc *k8sv1.PersistentVolumeClaim) *cdiv1.DataVolume
- func NewPVCDefinition(pvcName string, size string, annotations, labels map[string]string) *k8sv1.PersistentVolumeClaim
- func NewPodWithPVC(podName, cmd string, pvc *k8sv1.PersistentVolumeClaim) *k8sv1.Pod
- func NewSecretDefinition(labels, stringData map[string]string, data map[string][]byte, ...) *v1.Secret
- func PodGetNode(clientSet *kubernetes.Clientset, podName, namespace string) (string, error)
- func RequestUploadToken(clientSet *cdiClientset.Clientset, pvc *k8sv1.PersistentVolumeClaim) (string, error)
- func RunGoCLICommand(cliPath string, args ...string) ([]byte, error)
- func UploadImageFromNode(clientSet *kubernetes.Clientset, cliCommandPath, token string) error
- func UploadPVCDefinition() *k8sv1.PersistentVolumeClaim
- func UploadPodName(pvc *k8sv1.PersistentVolumeClaim) string
- func WaitForDataVolumePhase(clientSet *cdiclientset.Clientset, namespace string, ...) error
- func WaitForDeploymentReplicasReady(c *kubernetes.Clientset, namespace, name string) error
- func WaitForDeploymentReplicasReadyOrDie(c *kubernetes.Clientset, namespace, name string)
- func WaitForPVCAnnotation(clientSet *kubernetes.Clientset, namespace string, ...) (string, bool, error)
- func WaitForPVCAnnotationWithValue(clientSet *kubernetes.Clientset, namespace string, ...) (bool, error)
- func WaitForPersistentVolumeClaimPhase(clientSet *kubernetes.Clientset, namespace string, ...) error
- func WaitPVCUploadPodStatusRunning(clientSet *kubernetes.Clientset, pvc *k8sv1.PersistentVolumeClaim) (bool, error)
- func WaitPodDeleted(clientSet *kubernetes.Clientset, podName, namespace string, ...) (bool, error)
- func WaitTimeoutForPodReady(clientSet *kubernetes.Clientset, podName, namespace string, ...) error
- func WaitTimeoutForPodStatus(clientSet *kubernetes.Clientset, podName, namespace string, ...) error
- func WaitTimeoutForPodSucceeded(clientSet *kubernetes.Clientset, podName, namespace string, ...) error
Constants ¶
const ( // cdi-file-host pod/service relative values FileHostName = "cdi-file-host" // deployment and service name FileHostNs = "kube-system" // deployment and service namespace FileHostS3Bucket = "images" // s3 bucket name (e.g. http://<serviceIP:port>/FileHostS3Bucket/image) AccessKeyValue = "admin" // http && s3 username, see hack/build/docker/cdi-func-test-file-host-http/htpasswd SecretKeyValue = "password" // http && s3 password, ditto HttpAuthPort = 81 // cdi-file-host service auth port HttpNoAuthPort = 80 // cdi-file-host service no-auth port, requires AccessKeyValue and SecretKeyValue S3Port = 9000 // cdi-file-host service S3 port, requires AccessKey and SecretKeyValue )
const ( DataVolumeCreateTime = 30 * time.Second DataVolumeDeleteTime = 30 * time.Second DataVolumePhaseTime = 30 * time.Second )
const ( SecretPollPeriod = defaultPollPeriod SecretPollInterval = defaultPollInterval )
const ( ServicePollInterval = defaultPollInterval ServicePollPeriod = defaultPollPeriod )
const (
// DefaultPvcMountPath is the default mount path used
DefaultPvcMountPath = "/pvc"
)
const (
// PodWaitForTime is the time to wait for Pod operations to complete
PodWaitForTime = defaultPollPeriod
)
const (
TinyCoreIsoURL = "http://cdi-file-host.kube-system/tinyCore.iso"
)
const (
// UploadFileMD5 is the expected MD5 of the uploaded file
UploadFileMD5 = "2a7a52285c846314d1dbd79e9818270d"
)
Variables ¶
This section is empty.
Functions ¶
func CreateDataVolumeFromDefinition ¶
func CreateDataVolumeFromDefinition(clientSet *cdiclientset.Clientset, namespace string, def *cdiv1.DataVolume) (*cdiv1.DataVolume, error)
func CreateExecutorPodWithPVC ¶
func CreateExecutorPodWithPVC(clientSet *kubernetes.Clientset, podName, namespace string, pvc *k8sv1.PersistentVolumeClaim) (*k8sv1.Pod, error)
CreateExecutorPodWithPVC creates a Pod with the passed in PVC mounted under /pvc. You can then use the executor utilities to run commands against the PVC through this Pod.
func CreatePVCFromDefinition ¶
func CreatePVCFromDefinition(clientSet *kubernetes.Clientset, namespace string, def *k8sv1.PersistentVolumeClaim) (*k8sv1.PersistentVolumeClaim, error)
CreatePVCFromDefinition creates a PVC in the passed in namespace from the passed in PersistentVolumeClaim definition. An example of creating a PVC without annotations looks like this: CreatePVCFromDefinition(client, namespace, NewPVCDefinition(name, size, nil, nil))
func CreatePod ¶
func CreatePod(clientSet *kubernetes.Clientset, namespace string, podDef *k8sv1.Pod) (*k8sv1.Pod, error)
CreatePod calls the Kubernetes API to create a Pod
func DeleteDataVolume ¶
func DeleteDataVolume(clientSet *cdiclientset.Clientset, namespace string, dataVolume *cdiv1.DataVolume) error
Delete the passed in DataVolume
func DeletePVC ¶
func DeletePVC(clientSet *kubernetes.Clientset, namespace string, pvc *k8sv1.PersistentVolumeClaim) error
DeletePVC deletes the passed in PVC
func DownloadImageToNode ¶
func DownloadImageToNode(clientSet *kubernetes.Clientset, cliCommandPath string) error
DownloadImageToNode downloads an image file to node01 in the cluster
func FindPVC ¶
func FindPVC(clientSet *kubernetes.Clientset, namespace, pvcName string) (*k8sv1.PersistentVolumeClaim, error)
FindPVC Fins the passed in PVC
func FindPodByPrefix ¶
func FindPodByPrefix(clientSet *kubernetes.Clientset, namespace, prefix, labelSelector string) (*k8sv1.Pod, error)
FindPodByPrefix finds the first pod which has the passed in prefix. Returns error if multiple pods with the same prefix are found.
func FormatTestData ¶
FormatTestData accepts the path of a single file (srcFile) and attempts to generate an output file in the format defined by targetFormats (e.g. ".tar", ".gz" will produce a .tar.gz formatted file). The output file is written to the directory in `tgtDir`. returns:
(string) Path of output file (error) Errors that occur during formatting
func GetServiceInNamespace ¶
GetServiceInNamespace retries get on service `name` in namespace `ns` until timeout or IsNotFound error. Ignores api errors that may be intermittent. Returns pointer to service (nil on error) or an error (nil on success)
func GetServiceInNamespaceOrDie ¶
func GetServiceInNamespaceOrDie(c *kubernetes.Clientset, ns, name string) *v1.Service
GetServiceInNamespaceOrDie attempts to get the service in namespace `ns` by `name`. Returns pointer to service on success. Panics on error.
func GetServiceNodePortByName ¶
GetServiceNodePortByName scans a service's nodePorts for a name matching the `name` parameter and returns the associated port integer or an error if not match is found.
func GetServicePortByName ¶
GetServicePortByName scans a service's ports for names matching `name`. Returns integer port value (0 on error) and error (nil on success).
func GetServicesInNamespaceByLabel ¶
func GetServicesInNamespaceByLabel(c *kubernetes.Clientset, ns, labelSelector string) (*v1.ServiceList, error)
GetServicesInNamespaceByLabel retries get of services in namespace `ns` by `labelSelector` until timeout. Ignores api errors that may be intermittent. Returns pointer to ServiceList (nil on error) and an error (nil on success)
func NewDataVolumeWithHttpImport ¶
func NewDataVolumeWithHttpImport(dataVolumeName string, size string, httpUrl string) *cdiv1.DataVolume
func NewDataVolumeWithPVCImport ¶
func NewDataVolumeWithPVCImport(dataVolumeName string, size string, targetPvc *k8sv1.PersistentVolumeClaim) *cdiv1.DataVolume
func NewPVCDefinition ¶
func NewPVCDefinition(pvcName string, size string, annotations, labels map[string]string) *k8sv1.PersistentVolumeClaim
NewPVCDefinition creates a PVC definition using the passed in name and requested size. You can use the following annotation keys to request an import or clone. The values are defined in the controller package AnnEndpoint AnnSecret AnnCloneRequest You can also pass in any label you want.
func NewPodWithPVC ¶
func NewPodWithPVC(podName, cmd string, pvc *k8sv1.PersistentVolumeClaim) *k8sv1.Pod
NewPodWithPVC creates a new pod that mounts the given PVC
func NewSecretDefinition ¶
func PodGetNode ¶
func PodGetNode(clientSet *kubernetes.Clientset, podName, namespace string) (string, error)
PodGetNode returns the node on which a given pod is executing
func RequestUploadToken ¶
func RequestUploadToken(clientSet *cdiClientset.Clientset, pvc *k8sv1.PersistentVolumeClaim) (string, error)
RequestUploadToken sends an upload token request to the server
func RunGoCLICommand ¶
RunGoCLICommand egecutes gocli with given args
func UploadImageFromNode ¶
func UploadImageFromNode(clientSet *kubernetes.Clientset, cliCommandPath, token string) error
UploadImageFromNode uploads the image to the upload proxy
func UploadPVCDefinition ¶
func UploadPVCDefinition() *k8sv1.PersistentVolumeClaim
UploadPVCDefinition creates a PVC with the upload target annotation
func UploadPodName ¶
func UploadPodName(pvc *k8sv1.PersistentVolumeClaim) string
UploadPodName returns the name of the upload server pod associated with a PVC
func WaitForDataVolumePhase ¶
func WaitForDataVolumePhase(clientSet *cdiclientset.Clientset, namespace string, phase cdiv1.DataVolumePhase, dataVolumeName string) error
Wait for the DataVolume to be in a particular phase (Pending, Bound, or Lost)
func WaitForDeploymentReplicasReady ¶
func WaitForDeploymentReplicasReady(c *kubernetes.Clientset, namespace, name string) error
func WaitForDeploymentReplicasReadyOrDie ¶
func WaitForDeploymentReplicasReadyOrDie(c *kubernetes.Clientset, namespace, name string)
func WaitForPVCAnnotation ¶
func WaitForPVCAnnotation(clientSet *kubernetes.Clientset, namespace string, pvc *k8sv1.PersistentVolumeClaim, annotation string) (string, bool, error)
WaitForPVCAnnotation waits for an anotation to appear on a PVC
func WaitForPVCAnnotationWithValue ¶
func WaitForPVCAnnotationWithValue(clientSet *kubernetes.Clientset, namespace string, pvc *k8sv1.PersistentVolumeClaim, annotation, expected string) (bool, error)
WaitForPVCAnnotationWithValue waits for an annotation with a specific value on a PVC
func WaitForPersistentVolumeClaimPhase ¶
func WaitForPersistentVolumeClaimPhase(clientSet *kubernetes.Clientset, namespace string, phase k8sv1.PersistentVolumeClaimPhase, pvcName string) error
WaitForPersistentVolumeClaimPhase waits for the PVC to be in a particular phase (Pending, Bound, or Lost)
func WaitPVCUploadPodStatusRunning ¶
func WaitPVCUploadPodStatusRunning(clientSet *kubernetes.Clientset, pvc *k8sv1.PersistentVolumeClaim) (bool, error)
WaitPVCUploadPodStatusRunning waits for the upload server pod status annotation to be Running
func WaitPodDeleted ¶
func WaitPodDeleted(clientSet *kubernetes.Clientset, podName, namespace string, timeout time.Duration) (bool, error)
WaitPodDeleted waits fo a pod to no longer exist returns whether the pod is deleted along with any error
func WaitTimeoutForPodReady ¶
func WaitTimeoutForPodReady(clientSet *kubernetes.Clientset, podName, namespace string, timeout time.Duration) error
WaitTimeoutForPodReady waits for the given pod to be created and ready
func WaitTimeoutForPodStatus ¶
func WaitTimeoutForPodStatus(clientSet *kubernetes.Clientset, podName, namespace string, status k8sv1.PodPhase, timeout time.Duration) error
WaitTimeoutForPodStatus waits for the given pod to be created and have a expected status
func WaitTimeoutForPodSucceeded ¶
func WaitTimeoutForPodSucceeded(clientSet *kubernetes.Clientset, podName, namespace string, timeout time.Duration) error
WaitTimeoutForPodSucceeded waits for pod to succeed
Types ¶
This section is empty.