Разделы
На этой странице

Лимиты и вопросы

Размеры файлов, квота, правила имён, сроки хранения, частые вопросы и что значит каждое сообщение об ошибке Артефактория.

Лимиты

ЧтоОграничение
Размер одного файла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На сервере нет хранилищаОбратиться к администратору окружения