opscli file Command Usage

The opscli file command is used for transferring files between the local host, object storage, and clusters. Below are the details for various use cases.

1. Host - Local and Object Storage File Transfer

Set AK/SK (Access Key / Secret Key)

export ak=<your-ak>
export sk=<your-sk>

Upload a Local File to Object Storage

To upload a file ./tmp.log to the object storage at s3://logs/tmp.log:

/usr/local/bin/opscli file --direction upload --localfile ./tmp.log --remotefile s3://logs/tmp.log --bucket obs-test

Here:

--bucket is the S3 bucket name.
--region is the S3 bucket's region.
--endpoint is the S3 bucket's endpoint.
--direction specifies the upload direction.
--localfile is the local file to be uploaded.
--remotefile is the destination file in object storage.
Download a File from S3 to Local

To download s3://logs/tmp.log to the local file ./tmp1.log:

/usr/local/bin/opscli file --direction download --localfile ./tmp1.log --remotefile s3://logs/tmp.log --bucket obs-test

Unset AK/SK

To clear the AK/SK environment variables:

unset ak
unset sk

2. Cluster - Local and Object Storage File Transfer

Upload to Object Storage from Cluster

/usr/local/bin/opscli file -i ~/.kube/config --nodename xxx --direction upload --ak xxx --sk xxx --region beijing --endpoint ks3-cn-beijing.ksyun.com --bucket multimodal --localfile /root/tmp.log --remotefile s3://logs/tmp.log --runtimeimage shaowenchen/ops-cli

Download from Object Storage to Cluster

/usr/local/bin/opscli file -i ~/.kube/config --nodename xxx --direction download --ak xxx --sk xxx --region beijing --endpoint ks3-cn-beijing.ksyun.com --bucket multimodal --localfile /root/tmp2.log --remotefile s3://logs/tmp.log --runtimeimage shaowenchen/ops-cli

3. Cluster - Copy Image File to Local

To copy an image file from the cluster to the local machine:

/usr/local/bin/opscli file -i ~/.kube/config --nodename xxx --direction download --localfile /root/opscli-copy --remotefile shaowenchen/ops-cli:latest:///usr/local/bin/opscli

This command helps copy the executable or file from a container/image inside the cluster to the local machine.

4. Mount Host Paths to Container

The --mount flag allows you to mount host paths into the container when transferring files. This is useful for accessing host files or directories from within the container.

Single Mount

opscli file -i ~/.kube/config --nodename node1 \
    --direction upload \
    --localfile /root/tmp.log \
    --remotefile s3://logs/tmp.log \
    --mount /opt/data:/data

Multiple Mounts

You can specify multiple mounts by using --mount multiple times:

opscli file -i ~/.kube/config --nodename node1 \
    --direction upload \
    --localfile /root/tmp.log \
    --remotefile s3://logs/tmp.log \
    --mount /opt/data:/data \
    --mount /opt/logs:/logs

Mount Format

The mount format is: hostPath:mountPath

hostPath: absolute path on the host (required)
mountPath: absolute path in the container (required)

Note: If you need to access the host root filesystem for file operations, you can mount it explicitly:

opscli file --mount /:/host ...

File