mc
RELEASE.2024-11-05T11-29-45Z
Documentação MC
MinIO Client (mc) fornece uma alternativa moderna para comandos UNIX como ls, cat, cp, mirror, diff, find etc. Ele oferece suporte a sistemas de arquivos e serviço de armazenamento em nuvem compatível com Amazon S3 (AWS Signature v2 e 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: Os exemplos acima executam mc no ambiente de jogo MinIO por padrão. Para executar mc em outros servidores compatíveis com S3, inicie o contêiner desta forma:
docker run -it --entrypoint=/bin/sh minio/mc
em seguida, use o comando mc alias .
Ao usar o contêiner Docker no GitLab CI, você deve definir o ponto de entrada como uma string vazia.
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>
Instale pacotes mc usando Homebrew
brew install minio/stable/mc mc --help
| Plataforma | Arquitetura | 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 | ARM 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 | Arquitetura | URL |
|---|---|---|
| Microsoft Windows | Intel de 64 bits | https://dl.min.io/client/mc/release/windows-amd64/mc.exe |
mc.exe --help
A instalação do código-fonte destina-se apenas a desenvolvedores e usuários avançados. Se você não tiver um ambiente Golang funcional, siga Como instalar o Golang. A versão mínima necessária é go1.22
vá instalar github.com/minio/mc@latest
Se você planeja usar mc apenas em sistemas de arquivos compatíveis com POSIX, você pode pular esta etapa e prosseguir para o uso diário.
Para adicionar um ou mais hosts compatíveis com Amazon S3, siga as instruções abaixo. mc armazena todas as suas informações de configuração no arquivo ~/.mc/config.json .
mc alias set <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api <API-SIGNATURE> --path <BUCKET-LOOKUP-TYPE>
<ALIAS> é simplesmente um nome abreviado para o seu serviço de armazenamento em nuvem. O endpoint S3, o acesso e as chaves secretas são fornecidos pelo seu provedor de armazenamento em nuvem. A assinatura da API é um argumento opcional. Por padrão, está definido como "S3v4".
Caminho é um argumento opcional. É usado para indicar se as solicitações de URL de estilo de caminho ou DNS são suportadas pelo servidor. Ele aceita "on", "off" como valores válidos para ativar/desativar solicitações de estilo de caminho. Por padrão, é definido como "auto" e o SDK determina automaticamente o tipo de pesquisa de URL a ser usada.
O banner de inicialização do servidor MinIO exibe URL, acesso e chaves secretas.
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Obtenha seu AccessKeyID e SecretAccessKey seguindo o Guia de credenciais da AWS.
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Observação : como usuário do IAM no Amazon S3, você precisa garantir que o usuário tenha acesso total aos buckets ou definir a seguinte política restrita para seu usuário do IAM
{"Versão": "17/10/2012","Declaração": [
{"Sid": "AllowBucketStat","Effect": "Allow","Action": ["s3:HeadBucket"],"Resource": "*"},
{"Sid": "AllowThisBucketOnly","Effect": "Allow","Action": "s3:*","Resource": ["arn:aws:s3:::<your-restricted-bucket>/* ","arn:aws:s3:::<seu-restricted-bucket>"]
}
]
}Obtenha seu AccessKeyID e SecretAccessKey seguindo o Guia de credenciais do Google
mc alias set gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
mc é pré-configurado com https://play.min.io, alias como "play". É um servidor MinIO hospedado para fins de teste e desenvolvimento. Para testar o Amazon S3, basta substituir “play” por “s3” ou pelo alias usado no momento da configuração.
Exemplo:
Liste todos os buckets 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/
O comando Faça um bucket mb cria um novo bucket.
Exemplo:
mc mb play/mybucket Bucket created successfully `play/mybucket`.
O comando Copiar Objetos cp copia dados de uma ou mais fontes para um destino.
Exemplo:
mc cp myobject.txt play/mybucket myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Você pode adicionar aliases de shell para substituir suas ferramentas Unix comuns.
alias ls='mc ls' alias cp='mc cp' alias cat='mc cat' alias mkdir='mc mb' alias pipe='mc pipe' alias find='mc find'
Caso você esteja usando bash, zsh ou fish. A conclusão do shell é incorporada por padrão em mc , para instalar o preenchimento automático, use mc --autocompletion . Reinicie o shell, mc completará automaticamente os comandos conforme mostrado abaixo.
mc <TAB> admin config diff find ls mirror policy session sql update watch cat cp event head mb pipe rm share stat version
Siga o Guia do Colaborador MinIO
O uso do mc é regido pela licença GNU AGPLv3 que pode ser encontrada no arquivo LICENSE.
