mc
RELEASE.2024-11-05T11-29-45Z
документация МК
Клиент MinIO (mc) представляет собой современную альтернативу командам UNIX, таким как ls, cat, cp, Mirror, diff, find и т. д. Он поддерживает файловые системы и облачный сервис хранения данных, совместимый с Amazon S3 (AWS Signature v2 и 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
Примечание. Приведенные выше примеры по умолчанию запускают mc в игровой среде MinIO. Чтобы запустить mc на других серверах, совместимых с S3, запустите контейнер следующим образом:
docker run -it --entrypoint=/bin/sh minio/mc
затем используйте команду mc alias .
При использовании контейнера Docker в GitLab CI вы должны установить точку входа в пустую строку.
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>
Установите пакеты mc с помощью Homebrew.
brew install minio/stable/mc mc --help
| Платформа | Архитектура | URL-адрес |
|---|---|---|
| ГНУ/Линукс | 64-битный Intel | https://dl.min.io/client/mc/release/linux-amd64/mc |
| ГНУ/Линукс | 64-битная КПП | https://dl.min.io/client/mc/release/linux-ppc64le/mc |
| ГНУ/Линукс | 64-битная ARM | 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
| Платформа | Архитектура | URL-адрес |
|---|---|---|
| Microsoft Windows | 64-битный Intel | https://dl.min.io/client/mc/release/windows-amd64/mc.exe |
mc.exe --help
Установка исходного кода предназначена только для разработчиков и опытных пользователей. Если у вас нет рабочей среды Golang, следуйте инструкциям по установке Golang. Минимальная требуемая версия — go1.22.
иди и установи github.com/minio/mc@latest
Если вы планируете использовать mc только в файловых системах, совместимых с POSIX, вы можете пропустить этот шаг и перейти к повседневному использованию.
Чтобы добавить один или несколько хостов, совместимых с Amazon S3, следуйте инструкциям ниже. mc хранит всю информацию о своей конфигурации в файле ~/.mc/config.json .
mc alias set <ALIAS> <YOUR-S3-ENDPOINT> <YOUR-ACCESS-KEY> <YOUR-SECRET-KEY> --api <API-SIGNATURE> --path <BUCKET-LOOKUP-TYPE>
<ALIAS> — это просто короткое имя вашей службы облачного хранения. Конечная точка S3, ключи доступа и секретные ключи предоставляются вашим поставщиком облачного хранилища. Подпись API является необязательным аргументом. По умолчанию установлено значение «S3v4».
Путь — необязательный аргумент. Он используется для указания того, поддерживаются ли сервером DNS-запросы или URL-адреса в стиле пути. Он принимает «вкл», «выкл» в качестве допустимых значений для включения/выключения запросов стиля пути. По умолчанию для него установлено значение «авто», и SDK автоматически определяет тип используемого поиска URL-адреса.
Баннер запуска сервера MinIO отображает URL-адрес, доступ и секретные ключи.
mc alias set minio http://192.168.1.51 BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Получите AccessKeyID и SecretAccessKey, следуя Руководству по учетным данным AWS.
mc alias set s3 https://s3.amazonaws.com BKIKJAA5BMMU2RHO6IBB V7f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
Примечание . Как пользователь IAM на Amazon S3, вам необходимо убедиться, что у пользователя есть полный доступ к корзинам, или установить следующую ограниченную политику для вашего пользователя IAM.
{"Версия": "17.10.2012","Заявление": [
{"Sid": "AllowBucketStat", "Effect": "Allow", "Action": ["s3:HeadBucket"], "Resource": "*"},
{"Sid": "AllowThisBucketOnly","Effect": "Allow","Action": "s3:*","Resource": ["arn:aws:s3:::<ваш-ограниченный-ведро>/* ","arn:aws:s3:::<ваше-ограниченное-ведро>"]
}
]
}Получите AccessKeyID и SecretAccessKey, следуя Руководству по учетным данным Google.
mc alias set gcs https://storage.googleapis.com BKIKJAA5BMMU2RHO6IBB V8f1CwQqAcwo80UEIJEjc5gVQUSSx5ohQ9GSrr12
mc предварительно настроен с помощью https://play.min.io под псевдонимом «play». Это размещенный сервер MinIO для целей тестирования и разработки. Чтобы протестировать Amazon S3, просто замените «play» на «s3» или псевдоним, который вы использовали во время настройки.
Пример:
Список всех сегментов с 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/
Команда Make a Bucket mb создает новую корзину.
Пример:
mc mb play/mybucket Bucket created successfully `play/mybucket`.
Копировать объекты Команда cp копирует данные из одного или нескольких источников в целевой объект.
Пример:
mc cp myobject.txt play/mybucket myobject.txt: 14 B / 14 B ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ 100.00 % 41 B/s 0
Вы можете добавить псевдонимы оболочки, чтобы переопределить обычные инструменты 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'
Если вы используете bash, zsh или fish. Завершение оболочки по умолчанию встроено в mc , для установки автозаполнения используйте mc --autocompletion . Перезапустите оболочку, mc автоматически заполнит команды, как показано ниже.
mc <TAB> admin config diff find ls mirror policy session sql update watch cat cp event head mb pipe rm share stat version
Пожалуйста, следуйте Руководству участника MinIO.
Использование mc регулируется лицензией GNU AGPLv3, которую можно найти в файле LICENSE.
