Разделы
На этой странице
Лимиты и вопросы
Размеры файлов, квота, правила имён, сроки хранения, частые вопросы и что значит каждое сообщение об ошибке Артефактория.
Лимиты
| Что | Ограничение |
|---|---|
| Размер одного файла | 5 ГБ |
| Загрузка агентом одним запросом | 16 МБ; больше — загрузка частями (large: true) |
| Незавершённая загрузка частями | Живёт 24 часа |
Чтение текста агентом (artifact_read_text) | 1 МБ; больше — ссылка на скачивание |
| Ссылка на скачивание | Живёт 5 минут |
| Корзина | 7 дней, потом файл удаляется окончательно |
| Описание | 500 символов |
| Теги | До 50 на файл, каждый до 64 символов; пустые и повторы отбрасываются |
| Метаданные (задаёт агент) | Ключ — до 128 байт, всего — до 2 КБ |
| Имя файла или каталога | До 255 байт |
| Полный путь каталога | До 1024 байт |
| Превью картинки без нажатия | До 25 МБ |
| Превью текста и кода | До 1 МБ |
| Превью PDF | До 30 МБ |
Квота
Квота — сколько места могут занимать файлы. В неё входят все версии файлов и корзина.
- Сейчас квота — 1 ГБ на аккаунт владельца организации, общая для всех его организаций и проектов. На экране это подписано «Квота аккаунта владельца организации».
- Место резервируется в начале загрузки. Если файл не помещается, загрузка не начнётся — не будет ситуации «загрузилось 90% и упало».
- От 80% индикатор желтеет: «Хранилище заполнено больше чем на 80%». Агент через
artifact_quotaвидит то же предупреждение. - При 100% загрузка недоступна: «Квота исчерпана — загрузка недоступна». В вебе проверка идёт ещё до постановки в очередь, по суммарному размеру выбранных файлов: «Квота хранилища исчерпана: {занято} из {лимит}. Освободите место или смените тариф.»
- При исчерпанной квоте всё остальное работает: читать, скачивать, переименовывать, переносить и удалять файлы можно как обычно.
Как освободить место — кейс «Уборка квоты».
Правила имён
Нельзя:
- пустое имя,
.и..; - символы
/и\внутри имени файла или каталога (они разделяют путь); - управляющие символы;
- пробелы в начале и в конце имени.
Кириллица, пробелы внутри имени, эмодзи — можно. В одном каталоге не может быть двух файлов или двух подкаталогов с одинаковым именем. Корень нельзя удалить или перенести.
Доступ
- Файлы видят все участники организации, которой принадлежит проект. Права проверяются на каждом действии: человек, которого исключили из организации, сразу теряет доступ.
- Публичных ссылок нет. Ссылка на скачивание выдаётся на один файл, живёт 5 минут и нужна только для самого скачивания.
- Чужой проект неотличим от несуществующего: на запрос к нему придёт «project not found».
Частые вопросы
В меню нет пункта «Артефакторий». Артефакторий включается для аккаунтов поэтапно — для вашего его ещё не включили.
Экран пишет «Хранилище файлов пока не подключено к этому окружению».
На этом сервере Flownix нет хранилища файлов. Инструменты artifact_* в таком окружении
отвечают «artifact storage is not configured on this server».
Почему мой файл не находится поиском по смыслу? Поиск идёт по имени, каталогу, описанию и тегам, но не по содержимому. Добавьте описание — одно-два предложения о том, что в файле и зачем он. Новый файл попадает в индекс через несколько секунд, файлы из корзины в поиск не попадают.
Как загрузить новую версию файла?
Загрузите файл с тем же именем в тот же каталог и выберите «Новая версия». Агент передаёт
new_version: true.
Как вернуть старую версию? Скачайте её в «Истории версий» и загрузите как новую версию — она станет последней, а история сохранится.
Можно ли удалить одну версию? Нет, только файл целиком со всеми версиями.
Можно ли посмотреть видео прямо на экране? Пока нет: видео и аудио можно скачать, проигрывание появится позже.
Почему не удаляется файл? На него ссылаются задачи, документы или прогоны. Диалог покажет, кто именно; удалить можно кнопкой «Удалить всё равно» — ссылки станут ссылками на удалённый файл.
Не восстанавливается файл из корзины. На прежнем месте уже лежит файл с тем же именем. Переименуйте или перенесите его и повторите.
Можно ли перетащить файл в другой каталог мышью? Нет, перетаскивание работает только для загрузки из системы. Для переноса — «Переместить».
Где описание при загрузке через веб? При загрузке через веб описание не спрашивается — добавьте его в панели свойств сразу после загрузки.
Сообщения об ошибках
| Сообщение | Что значит | Что делать |
|---|---|---|
| name already exists in this folder | Файл с таким именем уже есть (агент без new_version, или восстановление на занятое место) | Загрузить как новую версию, переименовать или перенести мешающий файл |
Квота исчерпана — загрузка недоступна / plan_limit (artifact_storage) | Квота заполнена | Освободить место: удалить ненужное, очистить корзину |
| {имя}: файл больше 5 ГБ | Файл больше предела | Разбить или сжать |
| artifact is in use by AF-TASK-1, …; repeat with confirm to delete anyway | На файл ссылаются | Агенту — повторить с confirm: true, если удаление осознанное |
| only an artifact in the trash can be purged; delete it first | «Удалить навсегда» можно только из корзины | Сначала удалить в корзину |
| artifact is not in the trash | Восстанавливаемый файл не в корзине | Обновить список |
| description is required… | Агент загружает без описания | Добавить описание |
| description is longer than 500 characters | Описание длиннее 500 символов | Сократить |
| at most 50 tags / tag "…" is longer than 64 characters | Слишком много или слишком длинные теги | Сократить |
| content is larger than 16777216 bytes; use large=true | Агент шлёт больше 16 МБ одним запросом | Загрузка частями |
| sha256 does not match the content; the artifact was not created | Файл повредился при загрузке | Загрузить заново |
| upload has expired; start a new one | Загрузка частями не завершена за 24 часа | Начать загрузку заново |
| AF-ARTF-N is larger than 1 MB… / not a text file / not valid UTF-8 text | Агент пытается прочитать большой или двоичный файл как текст | Взять ссылку через artifact_download_url |
| the root folder cannot be deleted | Попытка удалить корень | — |
| Хранилище файлов пока не подключено к этому окружению. / artifact storage is not configured on this server | На сервере нет хранилища | Обратиться к администратору окружения |