AWS datasync: Add DataSync agent deployment on OpenShift Virtualization (KVM image)
Summary
Expands the agent deployment page to cover Red Hat OpenShift Virtualization using the KVM .qcow2 image, adding virtctl image-upload commands, a KubeVirt VirtualMachine manifest, and start/verification commands; also revises step 6 to only cover logging in and obtaining the agent IP.
Security assessment
The change is a functional deployment guide for a new hypervisor platform. The only security-adjacent element is guidance to use a Linux bridge network instead of the KubeVirt `masquerade` binding for throughput-sensitive transfers, which is framed as a performance consideration and carries no explicit security rationale, threat model, or hardening guidance. No vulnerability, CVE, credential handling, or authz change is referenced, so this is a low-severity documentation addition.
Evidence
+Save the following virtual machine configuration as `datasync-agent-vm.yaml`. For throughput-sensitive transfers, connect the agent to a Linux bridge network instead of the `masquerade` binding shown here.
Diff
diff --git a/datasync/latest/userguide/deploy-agents.md b/datasync/latest/userguide/deploy-agents.md index 6544e07..a293802 100644 --- a//datasync/latest/userguide/deploy-agents.md +++ b//datasync/latest/userguide/deploy-agents.md @@ -11 +11 @@ Deploying your agent on VMwareDeploying your agent on KVMDeploying your agent on -When creating an AWS DataSync agent, the first step is to deploy the agent in your storage environment. You can deploy an agent as a virtual machine (VM) on VMware ESXi, Linux Kernel-based Virtual Machine (KVM), Nutanix AHV (using the KVM image), and Microsoft Hyper-V hypervisors. You also can deploy an agent as an Amazon EC2 instance in a virtual private cloud (VPC) within AWS. +When creating an AWS DataSync agent, the first step is to deploy the agent in your storage environment. You can deploy an agent as a virtual machine (VM) on VMware ESXi, Linux Kernel-based Virtual Machine (KVM), Nutanix AHV (using the KVM image), Red Hat OpenShift Virtualization (using the KVM image), and Microsoft Hyper-V hypervisors. You also can deploy an agent as an Amazon EC2 instance in a virtual private cloud (VPC) within AWS. @@ -50 +50 @@ The agent VM's default credentials are login `admin` and password `password`. If -You can download an agent from the DataSync console and deploy it in your KVM environment. +You can download an agent from the DataSync console and deploy it in your KVM or OpenShift Virtualization environment. @@ -54 +54 @@ You can download an agent from the DataSync console and deploy it in your KVM en -###### To deploy an agent on KVM +###### To deploy an agent on KVM or OpenShift Virtualization @@ -68 +68,6 @@ You can download an agent from the DataSync console and deploy it in your KVM en - 5. Run the following command to install your `.qcow2` image. + 5. Deploy the agent image in your environment: + +KVM + + +Run the following command to install your `.qcow2` image. @@ -84 +89,51 @@ For information about how to manage this VM and your KVM host, see your hypervis - 6. Power on your hypervisor, log in to your VM, and get the IP address of the agent. You need this IP address to activate the agent. +Power on your hypervisor to start the agent VM. + +OpenShift Virtualization + + +Run the following command to import your `.qcow2` image into a persistent volume claim. + + virtctl image-upload dv datasync-agent-disk \ + --size=80Gi \ + --image-path=datasync-yyyymmdd-x86_64.qcow2 + +Save the following virtual machine configuration as `datasync-agent-vm.yaml`. For throughput-sensitive transfers, connect the agent to a Linux bridge network instead of the `masquerade` binding shown here. + + apiVersion: kubevirt.io/v1 + kind: VirtualMachine + metadata: + name: datasync-agent + spec: + runStrategy: Always + template: + spec: + domain: + cpu: + cores: 4 + memory: + guest: 32Gi + devices: + disks: + - name: rootdisk + disk: + bus: virtio + interfaces: + - name: default + masquerade: {} + model: virtio + networks: + - name: default + pod: {} + volumes: + - name: rootdisk + dataVolume: + name: datasync-agent-disk + +Run the following commands to start the VM. + + oc apply -f datasync-agent-vm.yaml + oc get vmi datasync-agent + +Wait for the VM's status to be **Running**. + + 6. Log in to your agent VM and get its IP address. You need this IP address to activate the agent.