mc
RELEASE.2024-11-05T11-29-45Z
documentación MC
MinIO Client (mc) proporciona una alternativa moderna a los comandos UNIX como ls, cat, cp, mirror, diff, find, etc. Admite sistemas de archivos y servicios de almacenamiento en la nube compatibles con Amazon S3 (AWS Signature v2 y v4).
alias manage server credentials in configuration file admin manage MinIO servers anonymous manage anonymous access to buckets and objects batch manage batch jobs cp copy objects cat display object contents diff list differences in object name, size, and date between two buckets du summarize disk usage recursively encrypt manage bucket encryption config event manage object notifications find search for objects get get s3 object to local head display first 'n' lines of an object ilm manage bucket lifecycle idp manage MinIO IDentity Provider server configuration license license related commands legalhold manage legal hold for object(s) ls list buckets and objects mb make a bucket mv move objects mirror synchronize object(s) to a remote site od measure single stream upload and download ping perform liveness check pipe stream STDIN to an object put upload an object to a bucket quota manage bucket quota rm remove object(s) retention set retention for object(s) rb remove a bucket replicate configure server side bucket replication ready checks if the cluster is ready or not sql run sql queries on objects stat show object metadata support support related commands share generate URL for temporary access to an object tree list buckets and objects in a tree format tag manage tags for bucket and object(s) undo undo PUT/DELETE operations update update mc to latest release version manage bucket versioning watch listen for object notification events
docker pull minio/mc docker run minio/mc ls play
docker pull minio/mc:edge docker run minio/mc:edge ls play
Nota: Los ejemplos anteriores ejecutan mc en el entorno de juego MinIO de forma predeterminada. Para ejecutar mc en otros servidores compatibles con S3, inicie el contenedor de esta manera:
docker run -it --entrypoint=/bin/sh minio/mc
luego use el comando mc alias .
Cuando utilice el contenedor Docker en GitLab CI, debe establecer el punto de entrada en una cadena vacía.
deploy: image: name: minio/mc entrypoint: [''] stage: deploy before_script: - mc alias set minio $MINIO_HOST $MINIO_ACCESS_KEY $MINIO_SECRET_KEY script: - mc cp <source> <destination>
Instalar paquetes mc usando Homebrew
brew install minio/stable/mc mc --help
| Plataforma | Arquitectura | URL |
|---|---|---|
| GNU/Linux | Intel de 64 bits | https://dl.min.io/client/mc/release/linux-amd64/mc |
| GNU/Linux | PPC de 64 bits | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
| GNU/Linux | BRAZO de 64 bits | https://dl.min.io/client/mc/release/linux-arm64/mc |
| Linux/s390x | S390X | https://dl.min.io/client/mc/release/linux-s390x/mc |
wget https://dl.min.io/client/mc/release/linux-amd64/mc chmod +x mc ./mc --help
| Plataforma | Arquitectura | URL |
|---|---|---|
| Windows | Intel de 64 bits | https://dl.min.io/client/mc/release/windows-amd64/mc.exe |
mc.exe --help
La instalación del código fuente solo está destinada a desarrolladores y usuarios avanzados. Si no tiene un entorno Golang que funcione, siga Cómo instalar Golang. La versión mínima requerida es go1.22
vaya a instalar github.com/minio/mc@latest
Si planea usar mc solo en sistemas de archivos compatibles con POSIX, puede omitir este paso y continuar con el uso diario.
Para agregar uno o más hosts compatibles con Amazon S3, siga las instrucciones a continuación. mc almacena toda su información de configuración en el archivo ~/.mc/config.json .
mc alias set <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api <API-SIGNATURE> --path <BUCKET-LOOKUP-TYPE>
<ALIAS> es simplemente un nombre corto para su servicio de almacenamiento en la nube. Su proveedor de almacenamiento en la nube proporciona el punto final S3, las claves de acceso y secretas. La firma de API es un argumento opcional. De forma predeterminada, está configurado en "S3v4".
La ruta es un argumento opcional. Se utiliza para indicar si el servidor admite solicitudes de URL de estilo de ruta o dns. Acepta "activado", "desactivado" como valores válidos para habilitar/deshabilitar solicitudes de estilo de ruta. De forma predeterminada, está configurado en "automático" y el SDK determina automáticamente el tipo de búsqueda de URL que se utilizará.
El banner de inicio del servidor MinIO muestra la URL, el acceso y las claves secretas.
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Obtenga su AccessKeyID y SecretAccessKey siguiendo la Guía de credenciales de AWS.
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Nota : como usuario de IAM en Amazon S3, debe asegurarse de que el usuario tenga acceso completo a los depósitos o establecer la siguiente política restringida para su usuario de IAM.
{"Versión": "2012-10-17","Declaración": [
{"Sid": "AllowBucketStat","Efecto": "Permitir","Acción": ["s3:HeadBucket"],"Recurso": "*"},
{"Sid": "AllowThisBucketOnly","Effect": "Allow","Action": "s3:*","Resource": ["arn:aws:s3:::<su-bucket-restringido>/* ","arn:aws:s3:::<su-depósito-restringido>"]
}
]
}Obtenga su AccessKeyID y SecretAccessKey siguiendo la Guía de credenciales de Google
mc alias set gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
mc está preconfigurado con https://play.min.io, con el alias "play". Es un servidor MinIO alojado con fines de prueba y desarrollo. Para probar Amazon S3, simplemente reemplace "play" con "s3" o el alias que utilizó en el momento de la configuración.
Ejemplo:
Enumere todos los depósitos de https://play.min.io
mc ls play [2016-03-22 19:47:48 PDT] 0B my-bucketname/ [2016-03-22 22:01:07 PDT] 0B mytestbucket/ [2016-03-22 20:04:39 PDT] 0B mybucketname/ [2016-01-28 17:23:11 PST] 0B newbucket/ [2016-03-20 09:08:36 PDT] 0B s3git-test/
Crear un depósito El comando mb crea un nuevo depósito.
Ejemplo:
mc mb play/mybucket Bucket created successfully `play/mybucket`.
El comando Copiar objetos cp copia datos de uno o más orígenes a un destino.
Ejemplo:
mc cp myobject.txt play/mybucket myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Puede agregar alias de shell para anular sus herramientas comunes de Unix.
alias ls='mc ls' alias cp='mc cp' alias cat='mc cat' alias mkdir='mc mb' alias pipe='mc pipe' alias find='mc find'
En caso de que estés usando bash, zsh o fish. La finalización del shell está integrada de forma predeterminada en mc ; para instalar la finalización automática, utilice mc --autocompletion . Reinicie el shell, mc completará automáticamente los comandos como se muestra a continuación.
mc <TAB> admin config diff find ls mirror policy session sql update watch cat cp event head mb pipe rm share stat version
Siga la Guía del colaborador de MinIO
El uso de mc se rige por la licencia GNU AGPLv3 que se puede encontrar en el archivo LICENCIA.
