Каталог расширений

Популярные теги

3gp       avi       fb2       jpg       mp3       pdf      

Как создать cf файл для обновления


Как создать cf файл конфигурации

В этой статье я научу Вас создавать cf файл конфигурации 1С. Что это за файл, и для каких целей он нужен? Ответим на первый вопрос:  в данный файл сохраняется конфигурация 1С.  Для каких целей чаще всего его используют? Для того, чтобы загрузить сохраненную конфигурацию в пустую базу. Но есть еще одно, назовем его так, «нестандартное применение».

При помощи cf-файла можно обновить конфигурацию 1С. Используя этот файл, Вы сможете перепрыгнуть сразу через несколько релизов, а не обновлять их поочередно с помощью cfu-файлов. Подробно о пошаговом обновлении конфигурации 1С читайте в моей статье:

Учимся обновлять конфигурации 1С

А в этой статье мы научимся создавать сf файл. Для этого необходимо войти в конфигуратор 1С.

Обращаю Ваше внимание, что у пользователя ,под которым Вы заходите в конфигуратор базы 1С должны быть права на работу с конфигуратором.

Для того чтобы создать файл cf, Вам необходимо открыть конфигурацию, если она закрыта. Очень часто она может быть закрыта. Чтобы её открыть, нажмем кнопку – открыть конфигурацию.

Конфигурация открылась, слева Вы можете увидеть список метаданных.

Если же Вы зашли в конфигуратор и увидели слева список метаданных, то это значит, что конфигурация уже открыта, и Вам ее открывать не надо. Обычно, когда она открыта, активна кнопка «Закрыть конфигурацию»

 

Если данная кнопка активна, но списка метаданных нет, то значит, что она просто не отображается.

Теперь нам необходимо сохранить конфигурацию в файл.

Идем в меню конфигурация, в котором выбираем пункт «Сохранить конфигурацию в файл»

Выбираем каталог, куда будем её сохранять, пишем имя файла. Я обычно пишу по названию конфигурации и номера релиза.

Все файл сохранился.

Теперь с  его помощью Вы сможете обновлять аналогичные конфигурации.

Посмотреть на процесс создания cf-файла «в живую» можно на видео ниже:


Как обновлять конфигурацию 1С при помощи cf-файла читайте мою следующую статью:

Обновляем конфигурацию 1С CF файлом

Изучайте основы конфигурирования в 1С и учитесь программировать в «1С: Предприятии» с помощью моих книг: «Программировать в 1С за 11 шагов» и «Основы разработки в 1С: Такси»

Книга «Программировать в 1С за 11 шагов»

Изучайте программирование в 1С в месте с моей книги «Программировать в 1С за 11 шагов»

  1. Книга написана понятным и простым языком — для новичка.
  2. Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
  3. Научитесь понимать архитектуру 1С;
  4. Станете писать код на языке 1С;
  5. Освоите основные приемы программирования;
  6. Закрепите полученные знания при помощи задачника;

Книга «Основы разработки в 1С: Такси»

Отличное пособие по разработке в управляемом приложении 1С, как для начинающих разработчиков, так и для опытных программистов.

  1. Очень доступный и понятный язык изложения
  2. Книга посылается на электронную почту в формате PDF. Можно открыть на любом устройстве!
  3. Поймете идеологию управляемого приложения 1С
  4. Узнаете, как разрабатывать управляемое приложение;
  5. Научитесь разрабатывать управляемые формы 1С;
  6. Сможете работать с основными и нужными элементами управляемых форм
  7. Программирование под управляемым приложением станет понятным

Промо-код на скидку в 15% — 48PVXHeYu


Если Вам помог этот урок решить какую-нибудь проблему, понравился или оказался полезен, то Вы можете поддержать мой проект, перечислив любую сумму:

можно оплатить вручную:

Яндекс.Деньги — 410012882996301
Web Money — R955262494655

Вступайте в мои группы:

Вконтакте: https://vk.com/1c_prosto
Фейсбуке: https://www.facebook.com/groups/922972144448119/
ОК: http://ok.ru/group/52970839015518
Твиттер: https://twitter.com/signum2009

CF Расширение файла - что это такое? Как открыть файл CF?

Следующий список составлен из базы данных, созданной программой Associate This! программа, выбранные данные из основной базы данных FILExt и информация о расширениях файлов, предоставленная пользователями.

ProgramID: cffile, AppName: Dreamweaver MX
EXEFile: Dreamweaver.exe


ProgramID: dwtfile, AppName: Dreamweaver


ProgramID: dwtfile, AppName: Dreamweaver


Программа: Dreamweaver


ArcSoft \ Software Suite \ Greeting Card Creator \ поздравительная открытка.exe% 1


ProgramID: GCFFile
EXEFile:% ProgramFiles% \ GCFScape \ GCFScape.exe% 1


ProgramID: Photoshop.CustomFilterKernel
EXEFile:% ProgramFiles% \ Adobe \ Photoshop 7.0 \ Photoshop.exe


ProgramID: Photoshop.CustomFilterKernel
EXEFile:% ProgramFiles% \ Adobe \ Photoshop CS \ Photoshop.exe


ProgramID: PNET.Document
EXEFile:% ProgramFiles% \ EarthLink TotalAccess \ Accelerator \ trayctl.exe% 1


ProgramID: SHCmdFile
EXEFile: explorer.exe


ProgramID: vcffile
EXEFile:% ProgramFiles% \ MI1933 ~ 1 \ Office10 \ OUTLOOK.EXE / v% 1


ProgramID: vcffile
EXEFile:% ProgramFiles% \ MI1933 ~ 1 \ OFFICE11. EXE / v% 1


ProgramID: vcffile
EXEFile:% ProgramFiles% \ MICROS ~ 2 \ Office10 \ OUTLOOK.EXE / v% 1


ProgramID: vcffile
EXEFile:% ProgramFiles% \ MICROS ~ 2 \ OFFICE11 \ OUTLOOK.EXE / v% 1


ProgramID: vcffile
EXEFile:% ProgramFiles% \ MICROS ~ 3 \ Office10 \ OUTLOOK.EXE / v% 1


ProgramID: vcffile
EXEFile:% ProgramFiles% \ MICROS ~ 3 \ OFFICE11 \ OUTLOOK.EXE / v% 1


ProgramID: vcffile
EXEFile:% ProgramFiles% \ MICROS ~ 4 Office10 \ OUTLOOK.EXE / v% 1


ProgramID: vcffile
EXEFile:% ProgramFiles% \ MICROS ~ 4 \ OFFICE11 \ OUTLOOK.EXE / v% 1


ProgramID: vcffile
EXEFile%:% ProgramFiles% msoffice \ OFFICE11 \ OUTLOOK.EXE / v% 1


ProgramID: insight.Конфигурация
EXEFile:% ProgramFiles% \ Source Insight 3 \ insight3.exe -i


a Данные проекта CF - это специальный формат файла, разработанный компанией Procedureimientos-Uno, S.L. и должны редактироваться и сохраняться только с помощью соответствующего программного обеспечения.

.

Как решить типичные проблемы с применением обновлений ColdFusion (в версии 10 и выше) - Charlie Arehart

Примечание: Это сообщение в блоге написано в 2016 году. Некоторое содержание может быть устаревшим, но не обязательно. То же самое со ссылками и последующими комментариями от меня или других. Исправления приветствуются, в комментариях. И я могу изменить содержание по мере необходимости.
Хотя в ColdFusion 10 и более поздних версиях добавлен новый механизм автоматической установки обновлений, что делать, если обновление не работает? На первый взгляд ответ может быть простым, но не очевидным для большинства.(И вы, скорее всего, попадете в режим паники.)

Многие обнаруживают после применения обновления ColdFusion, что либо CF не запускается вообще, либо они не могут получить доступ к администратору ColdFusion, либо некоторая часть CF или их приложение не работает . Проблема может заключаться просто в том, что в процессе обновления CF произошла ошибка, и ее довольно легко подтвердить и устранить.

В этом посте я поделюсь несколькими советами и наблюдениями, которые помогут решить эту проблему, на основе моих лет оказания поддержки удаленного устранения неполадок CF.

Версия TL; DR:
  • Проверьте журнал обновлений ColdFusion - журналы не в обычной папке журналов CF, а в журнале «установки» обновления и конкретной таблице успехов и ошибок там. Более подробно ниже.
  • И если есть ошибки, попробуйте остановить CF (и связанные с ним службы) самостоятельно, а затем повторите попытку обновления. Опять же, подробнее ниже.
  • Наконец, если это все еще не удается, вручную примените обновление из командной строки.Я также расскажу об этом подробнее ниже.

Если этого достаточно, чтобы вы начали, отлично - особенно если вы НАХОДИТЕСЬ в режиме паники! (Если вместо этого «проблема», которую вам нужно решить, заключается в том, что вы не можете заставить CF показывать вам обновления, потому что вы находитесь за брандмауэром, предотвращающим исходящий доступ в Интернет, я тоже помогу с этим, ближе к концу.)

Однако для большинства людей даже эти «простые дела» могут оказаться трудными (и это понятно). И вы можете найти различные ресурсы в Интернете, предлагающие, возможно, сокращенные обсуждения тем, поэтому я подробно остановлюсь на этом в этом посте.

И даже если вы в панике, на прочтение всего поста может уйти всего около 10 минут. (Конечно, вы также можете нанять меня, чтобы я помогал. См. Ссылки выше или ниже.) Надеюсь, что информация, которую я буду отслеживать, будет вам полезна.

Для более визуальных людей я также затронул большую часть этого в часовой презентации, которую я проводил на различных мероприятиях в последние годы, последняя из которых была записана на CFMeetup (ссылка на нее).

Вот разделы ниже:

Проверьте журнал обновлений...да, есть, но странно отформатирован

Поэтому первое, что нужно сделать после обновления ColdFusion (10 или выше), - это проверить установку обновления. И я НЕ имею в виду логи в папке "logs" CF. Среди них есть строчки, которые сообщают вам, ЧТО применено средство обновления, но не сообщают, если обновление было применено успешно.

Итак, да, есть журнал, посвященный отслеживанию успеха обновления, и он находится в другом месте (и в странном формате).И вам действительно следует проверить это, даже если обновление кажется или сообщает о себе как «успешное». Это легко сделать, если вы знаете, как это сделать:

  • См. Папку [cf] \ cfusion \ hf-updates \. (Я использую [cf] для общего обозначения папки cf10, 11, 2016 или 2016.) И там найдите подпапку, названную по номеру примененного вами обновления (например, hf-10-00021 или 2016, как hf-2016-00002-299200).
  • Там есть журнал, в названии которого указана дата / время установки (или удаления) обновления.обратите внимание, что я НЕ имею в виду файл hotfix_filelist.log (если в этой папке нет журнала обновлений, вы запускали ручное обновление, описанное ниже? Обратите внимание, что журнал не записывается, пока вы не нажмете кнопку «Готово» в пользовательском интерфейсе банки. если вы запускаете несколько экземпляров, ищите журнал в hf-обновлениях экземпляра cfusion, а не в других экземплярах.)
  • И в этом журнале установки (или удаления) обновления, примерно на 100 строк сверху вниз (НЕ переходите внизу, чтобы найти его) - это таблица с подсчетом успехов, предупреждений и ошибок.

Таблица может выглядеть так:

Сводка
-------

Установка: неуспешная.

373 успехов
1 предупреждений
0 нефатальных ошибок
1 фатальных ошибок

Если в таблице указаны все успехи, отлично. Ваше обновление прошло. Вы можете двигаться вместе со своим днем. :-)

Если он сообщает хотя бы об одной ошибке или нефатальной ошибке (и даже сообщает только о предупреждениях), значит, с обновлением что-то не так, и вы можете попробовать прочитать оставшуюся часть журнала, чтобы увидеть, есть ли среди нескольких сотен оставшихся строк оно может объяснить, что произошло.Это может быть сложно, потому что в некоторых обновлениях многие строки журнала могут содержать слово «ошибка» или «предупреждение», относящееся к файлам, которые были изменены в обновлении.

Но постарайтесь найти в журнале, что могло быть проблемой.

Наиболее частая причина сбоев обновления ColdFusion: CF не остановил

Почти во всех случаях, когда в обновлении есть ошибка, ответ на удивление прост (и он может даже сообщить об этом прямо, если вы посмотрите), но знать, что нужно искать, достаточно сложно.Для большинства решение проблемы может быть еще более сложной задачей, но это тоже довольно просто, если вы увидите, как это сделать.

Итак, наиболее частая причина, по которой я нахожу, заключается в том, что обновление не смогло остановить экземпляр (CF или других связанных процессов). Журнал может даже сообщить об этом конкретно в следующих строках:

  • Не удалось скопировать файлы исправлений: C: \ Users \ cfuser \ 288630.tmp \ dist \ cfusion: Не удалось скопировать файлы исправлений в целевое расположение. Повторите установку, убедившись, что сервер не работает или файлы не заблокированы сервером .
  • Не удалось скопировать файлы исправлений в целевое расположение: C: \ ColdFusion11 \ cfusion FATAL ERROR - C: \ ColdFusion11 \ cfusion \ jetty \ webapps \ PDFgServlet \ Resources \ bin \ HTML2PDFConverter.exe ( Процесс не может получить доступ к файлу потому что он используется другим процессом )

Другая ошибка, которую вы можете увидеть:

Не удалось удалить каталог: убедитесь, что сервер не запущен или файлы не заблокированы службой

Вы можете увидеть и другие.(Я приветствую комментарий, указывающий на других, чтобы я мог добавить их сюда и надеюсь, что люди найдут этот пост при поиске таких ошибок.)

Итак, вот проблема: механизм обновления (в CF Admin) должен останавливать экземпляр, затем создавать резервные копии файлов, которые нужно изменить, обновлять их, а затем снова запускать.

Но если экземпляр НЕ выходит из строя (или недостаточно быстро), то, когда обновление пытается продолжить замену или удаление файлов, которые нужно изменить, оно не может (потому что файлы заблокированы ОС), и поэтому обновление не выполняется. - не всегда, но почти всегда, по моему опыту.Мы можем обсудить, следует ли Adobe улучшить процесс обновления, чтобы ГАРАНТИРОВАТЬ, что CF не работает, прежде чем продолжить, но до тех пор, пока это не будет решено, эта информация применяется.

(И механизм обновления улучшился. В CF10 общая проблема заключается в том, что после того, как вы нажмете кнопку «ОК», чтобы запустить программу обновления, вы обнаружите, что в течение примерно 15-30 секунд ваш администратор CF обновится самостоятельно, и если CF еще не скопирован, вы получите сообщение об ошибке «» или «Служба временно недоступна» и что «Сервер временно не может обработать ваш запрос».В этом случае, возможно, он просто пытался обновить до того, как был скопирован. Просто попробуйте обновить администратора CF или проверьте, действительно ли CF резервное копирование. В CF11 это исправлено, так что установщик сообщает, что проверяет статус, и должен сообщить вам, когда все будет сделано. Я говорю «следует», потому что иногда этого не происходит, даже если обновление действительно завершено и работает. Опять же, если CF резервное копирование, попробуйте обновить администратора и посмотрите, появится ли у вас запрос на вход, а затем проверьте, применено ли обновление.)

В связи со всем этим я рекомендую один трюк (в ожидании обеих проблем, описанных выше): , вы всегда должны следить за процессом (процессами) CF до и во время обновления (на уровне ОС), чтобы убедиться, что экземпляр CF (как минимум) действительно останавливается и запускает .В случае Windows вы можете наблюдать на панели «Службы», которую можно обновить с помощью F5, команды меню «Действие> Обновить» или значка «Обновить» под меню.) Или в любой ОС просмотрите список запущенных процессов, чтобы увидеть ColdFusion. исчезнуть и появиться снова.

Если вы видите, что он опускается и поднимается, есть большая вероятность, что обновление произойдет. Тем не менее, вы можете пропустить, произойдет ли это, или все еще могут быть ошибки, поэтому еще раз просмотрите журнал обновлений, чтобы подтвердить успех или неудачу.)

Решение, которое будет работать в большинстве случаев: просто остановите службы, связанные с CF, затем перезапустите CF и повторите попытку обновления

Итак, если были ошибки, и либо журнал сообщает вам, что CF не остановился, либо вы просто не уверены, решение почти всегда заключается в том, что вы захотите остановить все процессы, которые могут указывать на файлы CF.

Это означает, по крайней мере, остановку связанных служб CF (таких как служба «Add On» ColdFusion, а также службы CF «.NET» и «ODBC» (если они установлены).Вы также можете остановить свой веб-сервер (если вы не используете CF 10 или 11 и не используете его для доступа к CF Admin).

Затем вы также можете перезапустить сам CF для хорошей меры (особенно если он был включен в течение длительного времени, прежде чем вы попробуете это), просто чтобы убедиться, что он может отключиться, когда это сделает средство обновления. Иногда одного этого шага (перезапуска CF самостоятельно) может быть достаточно, чтобы запустить обновление, если вы попробуете его снова!

Просто иногда, когда вы останавливаете CF в какой-то момент времени, он может выйти из строя быстрее, чем когда программа обновления пыталась остановить его в предыдущий момент времени.Вопрос о том, почему CF иногда медленно снижается или восстанавливается, действительно является темой для другого сообщения в блоге.

Я хочу сказать, однако, что вы можете обнаружить, что если вы остановите и запустите его, вы вполне можете обнаружить, что можете просто продолжить и применить обновление через администратора, как вы делали раньше, и оно может «внезапно» просто сработать!

Если это сработает, перейдите к разделу «Запускается ли CF после обновления? Отлично!» Ниже.

Но если эта попытка обновления ВСЕ ЕЩЕ содержит ошибки, пора переходить к следующему шагу.

Когда это все еще не работает: остановите CF (и связанные службы) и установите обновление из командной строки

Многие люди по какой-либо причине могут обнаружить, что просто не могут запустить обновление из пользовательского интерфейса администратора CF, поскольку они обнаруживают, что оно продолжает давать сбой. Для них следующее решение - остановить сам CF и оставить его выключенным, чтобы обновление работало.

Конечно, у есть одна ДЕЙСТВИТЕЛЬНО большая проблема с остановкой CF: вы не можете затем войти в CF Admin, чтобы запустить обновления, как вы это делали раньше.Дох! И именно здесь большинство застревает.

Хорошей новостью является то, что вы можете запускать обновления самостоятельно из командной строки. Вот где еще больше застревают, но это действительно довольно просто, и как только вы пройдете через это, вы даже можете всегда применять обновления таким образом, чтобы избежать вышеуказанных проблем!

Прежде чем продолжить, снова остановите CF и все связанные службы, как описано выше. Дело в том, что как только CF выходит из строя, меньше причин для блокировки файлов при запуске обновления.(И вы должны убедиться, что вы действительно больше не видите, что coldfusion работает как процесс.)

Продолжение установки обновления из командной строки

Что касается запуска обновления CF из командной строки, в основном, вы просто хотите перейти в место, где размещаются обновления при загрузке администратором CF ([cf] \ cfusion \ hf-updates), и оттуда запустить Java команда с аргументом "-jar", чтобы указать на запускаемый jar-файл обновления. В Windows, вероятно, будет разумно открыть командную строку от имени администратора.

Вот пример того, как это может работать при обновлении CF2016 в Windows. Конечно, вам может потребоваться изменить пути.

Это откроет установщик на основе java (который очень похож на сам установщик CF), и он пройдет несколько экранов для выполнения обновления.

Для получения дополнительной информации см. Сообщение в блоге Adobe об установке обновления из командной строки. Концепции в публикации применимы к CF10, 11, 2016 или 2018.

Тем не менее, я добавлю пару советов, которые вы должны иметь в виду, и пару ошибок, которые вы, возможно, захотите рассмотреть, прежде чем продолжить:

  • Хотя процесс обновления говорит, что он попытается остановить CF, снова, я все равно остановлюсь CF сам перед запуском ручного обновления .(И нет, нет ничего плохого в том, что он уже остановлен, когда в обновлении говорится, что оно попытается его остановить.)
  • Возможно, вы все равно захотите использовать предложение, которое я сделал выше, для , наблюдая за службами / процессами, чтобы убедиться, что CF действительно отключается и возвращайтесь к , особенно если вы не думали остановить CF самостоятельно.
  • Действительно, действительно гарантирует, что CF действительно вернется к . Хотя установщик ДОЛЖЕН запускать CF, я встречал случаи, когда он этого не делал, даже когда в обновлении не было ошибок.В этом случае запустите его как службу, как обычно.
  • Если вы заметили, что все связанные службы CF работают, но НЕ CF, имейте в виду, что установщик командной строки мог запустить CF НЕ как службу, а как процесс, запущенный под ВАШЕЙ учетной записью. Это нехорошо. Смотрите второе после следующего.
  • И если все в порядке, СЛЕДУЕТ проверить журнал установки, чтобы подтвердить количество успешных и ошибок . Он будет создан так же, как описано выше, и помещен в одно и то же место, независимо от того, запускается ли обновление от администратора CF или через этот установщик java из командной строки.

Многим это все, что им нужно. Если работает - отлично. Перейдите к разделу «CF работает сейчас после обновления? Отлично!» Ниже.

Но при работе с командной строкой следует остерегаться некоторых ошибок.

Остерегайтесь установки строки cmd: убедитесь, что используете тот же бит-уровень Java, что и CF!

Если вы ДЕЙСТВИТЕЛЬНО используете ручной установщик из командной строки, есть несколько возможных ошибок.

Первое может произойти, если у вас установлены разные версии Java, включая ту, которая была реализована так, что вы можете просто ввести Java в командной строке, и она будет работать (в ответ сообщается справка java).Если вы продолжите использовать это для установщика строки cmd выше, установщик вполне может запуститься и, похоже, завершится.

Но тогда вы можете обнаружить, что CF не запускается. Вы даже можете обнаружить, что (согласно обсуждению выше) в журнале обновлений не было ошибок, и все же служба CF не запускается! Вы можете запаниковать.

Но вот уловка: попробуйте запустить CF из командной строки (перейдя в папку / cfusion / bin и запустив cfstart). Сообщает ли он об ошибке загрузки jvm.dll.Что, черт возьми, случилось?

Это меня сбило с толку в первый раз. В конце концов я понял это: клиент, с которым я делал установщик строки cmd, по какой-то причине реализовал 32-битную Java JRE на своей машине, но CF был реализован как 64-битный (и сам указывал на 64-битную JVM ).

Нет ничего НЕПРАВИЛЬНОГО в наличии двух JVM с разными битовыми уровнями, как в этом случае, если у вас есть что-то, для чего нужна 32-битная jvm. Но для ясности, какую бы битовую версию CF вы ни установили, она должна использовать тот же битовый уровень JVM.И вам нужно использовать тот же битовый уровень для запуска установщика, иначе возникнет эта ошибка.

В этом случае 32-разрядная JVM была «общедоступной jre», так что, когда команда java запускалась в командной строке (без указания папки, в которой должен находиться исполняемый файл java, и при условии, что вы не работаете изнутри) папка с собственным исполняемым файлом java) запускалась именно эта 32-разрядная версия Java.

И проблема в том, что тогда программа обновления CF работала в 32-битном режиме и внедряла файлы в CF, которые теперь были 32-битными версиями, и поэтому CF тогда не запускался (поскольку его jvm был 64-битным, но эти Загружались 32-битные файлы в CF).

Итак, во-первых, как вы узнаете, является ли Java, запущенная в командной строке, 32-битной? Хорошо, если вы запустили команду с аргументом «-версия», чтобы сообщить информацию о ее версии:

java -version

если информация в последней показанной строке начинается с «Java HotSpot (TM) 64-Bit Server VM», это 64-битная виртуальная машина (очевидно), но если там просто написано «Java HotSpot (TM) Server VM», это является 32-битным (не так очевидно). Если он 32-битный, а ваш CF (и используемая им JVM) 64-битный, то вы НЕ ДОЛЖНЫ использовать ЭТУ 32-битную Java для запуска программы обновления.

(Прежде чем я скажу вам, какой ПРАВИЛЬНЫЙ запустить, вы хотите сначала удалить только что сделанное обновление, чтобы ОТМЕНИТЬ те «неправильные файлы», которые были реализованы. Я покажу вам, как это сделать через мгновение. Но сначала давайте продолжайте то, что вам СЛЕДУЕТ сделать, на случай, если люди, читающие это, еще не совершили ошибку, но поймали ее до того, как выполнили неправильную команду java битового уровня.)

Вместо этого вы хотите указать на 64-битную JVM. Вы можете указать на тот, который находится в папке JRE / bin CF, или, если вы изменили CF для использования другой JVM, вы можете указать на него.Если он был установлен в такую ​​папку, как C: \ Program Files \ Java \ jdk1.8.0_144, то вы можете запустить Java в этой папке с помощью этой команды (обратите внимание на использование кавычек, потому что в «программных файлах» есть место название):

и вы также можете использовать его для последующего запуска обновления, используя команду -jar и указывая на jar-файл исправлений, как обсуждалось в предыдущем разделе. Один вариант может быть:

А что, если вы запустили установщик (с 32-битной java) до того, как увидели этот пост, а CF не запускается? Что ж, вы можете удалить только что примененное обновление (и удалить эти 32-разрядные файлы Java, среди других обновленных файлов).Для этого перейдите в каталог «uninstall» в папке только что примененного обновления (в cfusion \ hf-updates) и используйте ту же 32-разрядную Java для удаления обновления:

java -jar uninstaller.jar

После этого удаления (и вы проверяете журнал, как обсуждалось выше, чтобы убедиться, что не было ошибок), CF вернется к тому уровню обновления, который был у вас до применения этого последнего обновления. И вы обнаружите, что CF ДЕЙСТВИТЕЛЬНО запускается. Но теперь начнем все сначала.Запустите обновление, которое вы хотели применить в первую очередь (используя java -jar, указывающий на jar-файл обновления, как обсуждалось в предыдущем разделе выше), но на этот раз УБЕДИТЕСЬ, чтобы запустить 64-битную команду Java, как только что обсуждалось. Затем проверьте журнал обновлений, и вы должны обнаружить, что CF запускается. Ура!

Еще одна хитрость, которую следует остерегаться, когда CF запускается ручным установщиком

Независимо от того, есть ли у вас последняя проблема или нет, есть еще одна потенциальная проблема, когда вы используете ручной установщик из командной строки.Хорошая новость в том, что это легко разрешается. Я уже упоминал, что после запуска установщика программа обновления попытается запустить CF. Это хорошая вещь. Но будьте осторожны.

Вы хотите следить за тем, какой пользователь CF "работает от имени" после того, как установщик командной строки запустит его. (Вы можете увидеть имя пользователя, который запускает любой процесс, в диспетчере задач в Windows или сверху в Linux.)

Проблема в том, что иногда я обнаруживал, что процесс ручного обновления правильно запускает CF как службу (в Windows или Linux), , в других случаях я видел, как он запускает CF БЕЗ запуска его как службы и, что еще хуже, запускается как пользователь, который запустил обновление .

На первый взгляд это может не показаться проблемой. CF по крайней мере "работает", но это может быть реальной проблемой, если служба CF (которая должна была запускаться от имени) настроена для работы от имени другого пользователя: будь то конкретный пользователь (лучше всего для безопасности) или значение по умолчанию «локальная система» (Windows) или root (Linux). Проблема в том, что пользователь, с которым ВЫ вошли в систему (для выполнения обновления), не может быть ни одним из них, и если CF работает под ЭТИМ пользователем, есть некоторые операции CFML, которые могут не работать из-за этого (у вас может не быть надлежащего разрешения).

Поэтому, если вы не видите, что служба запущена, или вы видите, что задача CF запущена, но не как пользователь, который бы ее запускал, как если бы она была запущена как служба, то завершите процесс (в Windows перейдите в Диспетчер задач, найдите the coldfusion.exe и уничтожьте его), а затем запустите службу самостоятельно (например, в Службах в Windows), как обычно. Тогда все должно быть хорошо.

Еще один аспект того, как эта проблема может вас укусить, заключается в том, что вы можете не заметить, что это произошло (ручное средство обновления запустило процесс CF, но НЕ службу CF), и затем вы можете попытаться запустить службу CF, только чтобы Сообщите, что он не может быть запущен. В приведенной выше ситуации это просто потому, что он уже запущен как процесс. Но вы можете немного паниковать, если какая-либо из перечисленных выше проблем могла произойти, и вы можете предположить, что «что-то не так». Вы можете даже не подумать просто проверить и увидеть, что, например, CF Admin хотя бы откроется (как, вероятно, ваш веб-сайт). Таким образом, в таком состоянии вы можете подумать, что вам нужно перезапустить устройство - когда все, что вам нужно сделать, снова остановить тот, который был запущен программой обновления, и ЗАТЕМ запустить службу.

CF работает теперь после обновления? Большой!

Итак, после того, как все эти возможные проблемы решены, если CF теперь запускается (как правильный пользователь, см. Выше), и вы можете получить доступ к своему администратору, и это показывает, что обновление действительно было применено, тогда все в порядке и рады помог.

(Что касается того, как проверить, что обновление было применено, помимо использования журнала, описанного выше, вы также можете проверить его на странице «обновления» администратора, конечно, на его вкладке «установленные обновления».Возможно, лучше было бы взглянуть на страницу «информация о системе» через «i» в правом верхнем углу администратора или на страницу «сводка настроек», указанную в левом меню в админке, которые сообщают о CF и jvm версия, на которой работает CF)

Опять же, на первый взгляд, : все вышеперечисленное довольно просто, если вы понимаете его (определение наличия ошибок в журналах, остановка CF и запуск обновления вручную). Это может быть буквально 5-минутной работой, если вы знаете, что делаете .

Но для людей, которые не знают, они могут простаивать часами или даже днями, что трагично. Я даже видел, как люди заходили так далеко, что пытались (или им предлагали) удалить / переустановить CF в надежде исправить такие проблемы ... и все, что для этого потребовалось, это остановить CF перед применением обновления!

См. Ниже информацию о том, как получить помощь, если вы все еще боретесь с какой-либо проблемой.

Еще одна «проблема» и ее решение: как скачать обновления CF вручную

Прежде чем завершить этот пост, возможно, у кого-то «проблема» с применением этих обновлений совсем другая: они могут обнаружить, что не могут даже ИСПОЛЬЗОВАТЬ функцию CF Admin для загрузки jar-файлов обновлений, потому что на их сервере нет доступ в интернет (в целях безопасности).

Хорошая новость заключается в том, что решение этой проблемы действительно существует, но, опять же, похоже, что многие об этом не знают (я не вижу, чтобы сообщество обычно предлагало это решение, когда люди жалуются на эту проблему в Интернете).

У Adobe есть страницы для каждого выпуска со списком доступных jar-файлов для CF10, 11 и 2016, например https://helpx.adobe.com/coldfusion/kb/coldfusion-2016-updates.html. (Вы можете изменить это на 10, 11 или 2018, чтобы получить для них банки.)

Вы просто загрузите оттуда желаемый файл jar и продолжите процесс обновления вручную из командной строки, как описано выше.(Имейте в виду, что иногда некоторые версии Windows или браузеров по ошибке преобразуют файл jar в zip-архив при его загрузке. Если это произойдет, просто переименуйте расширение обратно в "jar" перед запуском команды "java -jar" выше.)

Проблемы все еще возникают? Обратитесь за удаленной помощью

Если у вас по-прежнему возникают проблемы с применением обновления, вы, безусловно, можете добавить здесь комментарий, и я постараюсь вернуться к нему, но , возможно, лучше было бы просто обратиться за платной помощью .Извините, если это кажется коммерческим предложением, но я делюсь вышеизложенным, основываясь на моем опыте помощи людям. Такого рода устранение неполадок CF-сервера - это все, что я делаю ежедневно каждый день для сотен клиентов в год и более тысячи за последние 10 лет.

И некоторые люди действительно просто предпочли бы (или исправили бы проблему запросом) кого-то, кто помог бы убедиться, что все это учтено и сделано правильно за 15-30 минут, вместо того, чтобы бороться в одиночку, чтобы рассмотреть все проблемы выше.

Я почти всегда могу работать удаленно (через решения для общего рабочего стола, которые вам могут понравиться, например, gotomeeting, webex или мое предпочтительное присоединение.me, среди прочих), поэтому вам не нужно «предоставлять мне удаленный доступ» (например, RDP или ssh, которые требуют, чтобы вы предоставили мне или создали новые учетные данные, или может потребовать открытия дыры в брандмауэре или доступа к VPN). В решении для общего рабочего стола ничего из этого не требуется, и мы вместе рассмотрим проблему (я расскажу вам о проблеме и решении).

А нам может и не понадобиться очень долго : я могу решить многие проблемы менее чем за час. Вы можете найти больше о моих ставках, подходе, гарантии удовлетворения, отзывах клиентов и многом другом на этой странице консультаций / поддержки на моем сайте.

Для некоторых проблем есть только то, что можно разумно предвидеть заранее - даже учитывая все тонкости, как я делаю в сообщениях в блогах, презентациях, видео и многом другом. Часто бывает слишком много переменных, чтобы рассмотреть и полностью решить данную проблему в целом (хотя я все же пытаюсь, как показано выше).

В случаях, когда информации, которой я или кто-то делюсь, недостаточно, или если у вас есть какая-то другая сложная проблема, не терпите ее надолго . Я бы даже сказал, что не тратьте более 15 минут, пытаясь найти решение в Google (где вас могут увести во все виды кроличьих нор от благонамеренных людей или, возможно, устаревшая информация), если вместо этого вы можете положиться на кого-то, кто знает, что он делает, и может помочь вам найти решение, ориентированное на вашу конкретную проблему, вашу среду и ваш уровень навыков, - возможно, без особых затрат времени.Особенно когда ваше удовлетворение нам гарантировано!

Невозможно заменить спокойную, опытную руку того, кто «был там, сделал это», когда дело доходит до таких проблем, как применение обновлений, как указано выше, или если вы обновляете свою JVM и обнаруживаете, что CF не запускается, или проблемы, такие как миграция к новым выпускам CF или обновлению / настройке коннектора веб-сервера в CF10 и более поздних версиях и т. д.

Если бы эти проблемы было легко решить, вы бы нашли ответ в твите. Поскольку это не так (много движущихся частей, распространенные заблуждения), многие борются, возможно, находя только ту информацию, которую кто-то считал «наименее необходимой для обсуждения», и оставляя вас искать детали или, что еще хуже, решение проблем, когда дела идут не так, и они «упустили эту деталь».

Я хочу не только помочь вам решить вашу проблему, но и помочь вам понять, что произошло, почему это произошло и как, возможно, предотвратить это в будущем, будь то общедоступные ресурсы или прямой совет!

Сообщите мне, что вы думаете о проблемах и решениях выше.

Для получения дополнительных материалов, подобных этому от Чарли Арехарта: Нужна дополнительная помощь с проблемами?
  • Если вы предпочитаете прямую помощь, а не копаться здесь / где-то еще или через комментарии, он может помочь через свои онлайн-консультационные услуги
  • См. Эту страницу, чтобы узнать больше о том, как он может помочь а) через Интернет, безопасно и надежно , б) обычно очень быстро , в) обучая вас в процессе, и г) с гарантированным удовлетворением
.

Начало работы с cf CLI

В этом разделе описывается настройка и начало работы с интерфейсом командной строки Cloud Foundry (см. CLI).

Обзор

CLI cf является официальным клиентом командной строки для Cloud Foundry. Вы можете использовать cf CLI для управления приложениями, экземплярами служб, организациями, пространствами и пользователями. в вашем окружении.

Необходимое условие

Для выполнения процедур, описанных в этом разделе, необходимо загрузить и установить последнюю версию cf CLI.Для получения дополнительной информации см. Установка интерфейса командной строки Cloud Foundry.

Войти с помощью интерфейса командной строки

Команда cf login использует синтаксис, описанный ниже, для указания целевой конечной точки API, учетных данных для входа, организации и пробела.

Интерфейс командной строки cf запрашивает учетные данные при необходимости. Если вы являетесь участником нескольких организаций или пространств, cf login предложит вам, в какие из них следует войти. В противном случае он автоматически нацеливается на вашу организацию и пространство.

Для входа в cf CLI:

  1. Пробег:

      cf login -a API-URL -u ИМЯ ПОЛЬЗОВАТЕЛЯ -p ПАРОЛЬ -o ORG -s ПРОБЕЛ  

    Где:

    • API-URL - это ваша конечная точка API, api.run.pivotal.io .
    • ИМЯ ПОЛЬЗОВАТЕЛЯ - ваше имя пользователя.
    • ПАРОЛЬ - это ваш пароль. VMware не рекомендует использовать опцию -p , поскольку она может записать ваш пароль в историю вашей оболочки.
    • ORG - это организация, в которой вы хотите развернуть свои приложения.
    • ПРОСТРАНСТВО - это пространство в организации, где вы хотите развернуть свои приложения.

После успешного входа в систему вы увидите результат, как в примере ниже:

 $ cf логин -a https: // api.example.com -u [email protected] -o example-org -s development Конечная точка API: https://api.example.com Пароль> Аутентификация ... ОК Целевая организация example-org Целевое развитие пространства Конечная точка API: https://api.example.com Пользователь: [email protected] Организация: example-org Космос: разработка 

Войти через API

Вы можете написать сценарий для входа в cf CLI. Это позволяет избежать ручного входа в cf CLI каждый раз, когда вы его используете.

Чтобы написать скрипт для входа:

  1. Настройте свой API, запустив:

      cf api API-URL  

    Где API-URL - ваша конечная точка API, api.run.pivotal.io .

    Для получения дополнительных сведений см. Api в справочном руководстве по интерфейсу командной строки Cloud Foundry .

  2. Аутентифицировать, запустив:

      cf auth ПАРОЛЬ ИМЕНИ ПОЛЬЗОВАТЕЛЯ  

    Где:

  3. Настройте таргетинг на свою организацию или пространство, запустив:

      cf target -o ORG -s SPACE  

    Где:

После входа в систему cf CLI сохраняет конфигурацию .json , содержащий конечную точку API, организацию, значения пробелов и токен доступа.

Если вы измените эти параметры, файл config.json будет соответствующим образом обновлен.

По умолчанию config.json находится в каталоге ~ / .cf . Вы можете переместить файл config.json , используя переменную среды CF_HOME .

Локализация CLI

Интерфейс командной строки cf переводит вывод терминала на выбранный вами язык.Язык по умолчанию - en-US .

Интерфейс командной строки cf поддерживает следующие языки:

  • Китайский (упрощенный): zh-Hans
  • Китайский (традиционный): zh-Hant
  • Английский: en-US
  • Французский: fr-FR
  • Немецкий: de-DE
  • итальянский: it-IT
  • Японский: ja-JP
  • Корейский: ko-KR
  • Португальский (Бразилия): pt-BR
  • Испанский: es-ES

Дополнительные сведения см. В разделе config в справочном руководстве по интерфейсу командной строки Cloud Foundry .

Примечание: Локализация с помощью cf config --locale влияет только на сообщения, которые генерирует cf CLI.

Чтобы установить язык cf CLI:

  1. Войти в cf CLI:

      cf войти  
  2. Пробег:

      cf config --locale LANGUAGE  

    Где LANGUAGE - это код языка, который вы хотите установить.

  3. Подтвердите изменение языка, запустив:

      cf help  

    Команда возвращает вывод, аналогичный приведенному ниже примеру:

     $ cf help НОМЕР: cf - Uma ferramenta de linha de comando para intergir com Cloud Foundry USO: cf [opções globais] comando [arguments...] [opções de comando] ВЕРШО: 6.14.1 ... 

Управление пользователями и ролями

Интерфейс командной строки cf включает команды, которые выводят список пользователей и назначают роли в организациях и пространствах.

Список пользователей

Чтобы перечислить всех пользователей в организации или пространстве:

  1. Войти в cf CLI:

      cf войти  
  2. Выполните одну из этих команд:

      cf org-users  
    • Чтобы вывести список пользователей пространства, введите:
      см космических пользователей  

Команда возвращает вывод, аналогичный приведенному ниже примеру:

 $ cf org-users example-org Получение пользователей в org example-org как username @ example.ком ... МЕНЕДЖЕР ОРГАНИЗАЦИИ [email protected] БИЛЛИНГ-МЕНЕДЖЕР [email protected] [email protected] ОРГАНИЗАЦИОННЫЙ АУДИТОР [email protected] 

Для получения дополнительной информации см. Org-users и space-users в Cloud Foundry CLI Reference Guide .

Управление ролями

Вы используете перечисленные ниже команды для управления ролями в cf CLI. Эти команды требуют прав администратора и принимают имя пользователя, org или пространство и роль в качестве аргументов:

  • cf set-org-role
    Для получения дополнительной информации см. Set-org-role в Справочном руководстве Cloud Foundry CLI .

  • cf unset-org-role
    Для получения дополнительной информации см. Unset-org-role в справочном руководстве Cloud Foundry CLI .

  • cf set-space-role
    Для получения дополнительной информации см. Set-space-role в справочном руководстве Cloud Foundry CLI .

  • cf unset-space-role
    Для получения дополнительной информации см. Unset-space-role в Справочном руководстве по интерфейсу командной строки Cloud Foundry .

Доступные роли:

  • OrgManager
  • BillingManager
  • OrgAuditor
  • SpaceManager
  • SpaceDeveloper
  • SpaceAuditor

Дополнительные сведения о ролях пользователей см. В разделе Организации, пространства, роли и разрешения.

В приведенном ниже примере показан вывод командной строки cf для назначения роли Org Manager пользователю внутри организации:

 $ cf set-org-role [email protected] example-org OrgManager Назначение роли OrgManager пользователю [email protected] в org example-org как [email protected] ... ОК 

Примечание: Если вы не являетесь администратором, вы увидите это сообщение при попытке запустить следующие команды: код ошибки: 10003, сообщение: у вас нет прав для выполнения запрошенного действия

Управление ролями для пользователей с одинаковыми именами пользователей из нескольких источников

Если имя пользователя соответствует нескольким учетным записям из разных пользовательских хранилищ, таких как внутреннее хранилище UAA и внешнее хранилище SAML или LDAP, команды cf set-org-role и cf unset-org-role выше возвращают эта ошибка:

 Пользователь существует в нескольких источниках.Укажите источник для запрашиваемого пользователя: «uaa», «other» 

Чтобы устранить эту двусмысленность, можно создать команду curl , которая использует API для выполнения требуемой функции управления ролями. Пример см. В разделе «Связать аудитора с организацией по имени пользователя» в документации по Cloud Foundry API.

Нажмите приложение

В этих разделах описывается, как использовать команду cf push для отправки нового приложения или синхронизации изменений в существующем приложении.

Для получения дополнительной информации см. Push в справочном руководстве по интерфейсу командной строки Cloud Foundry .

Отправьте новое приложение или отправьте изменения в приложение

Чтобы отправить приложение:

  1. Войдите в cf CLI, запустив:

      cf войти  
  2. Перейдите в каталог приложения.

  3. Отправьте новое приложение или внесите изменения в приложение, запустив:

      cf push APP-NAME  

    Где APP-NAME - название приложения.

Отправка приложения с помощью манифеста

Вы можете указать путь к файлу манифеста при отправке приложения.Файл манифеста может включать в себя такую ​​информацию, как имя приложения, ограничение на диск и количество экземпляров. Вы можете использовать файл манифеста вместо того, чтобы добавлять флаги в команду cf push .

cf push по умолчанию находит файл manifest.yml в текущем рабочем каталоге. Или вы можете указать путь к манифесту с помощью флага -f .

Для получения дополнительных сведений о флаге -f см. Push в справочном руководстве Cloud Foundry CLI .

Примечание: Когда вы указываете имя приложения в командной строке, cf push использует это имя приложения независимо от того, есть ли в манифесте другое имя приложения. Если манифест описывает несколько приложений, вы можете отправить одно приложение, указав его имя в командной строке; cf CLI не подталкивает остальных. Используйте эти варианты поведения для тестирования.

Отправка приложения с помощью пакета сборки

Вы можете указать пакет сборки при отправке приложения с флагом -b .Если вы используете флаг -b для указания пакета сборки, приложение останется постоянно связанным с этим пакетом сборки. Чтобы использовать приложение с другим пакетом сборки, вы должны удалить приложение, а затем снова нажать на него.

Дополнительные сведения о доступных пакетах сборки см. В разделе Пакеты сборки.

В приведенном ниже примере приложение под названием awesome-app перемещается по URL-адресу http://awesome-app.example.com и указывает пакет сборки Ruby с флагом -b :

 $ cf push awesome-app -b ruby_buildpack Создание приложения awesome-app в org example-org / space development как username @ example.ком ... ОК Создание маршрута awesome-app.example.com ... ОК ... 1 из 1 запущенных экземпляров Приложение запущено ... запрошенное состояние: запущено экземпляры: 1/1 использование: 1 Гб x 1 экземпляр URL: awesome-app.example.com последняя загрузка: среда, 8 июня, 23:43:15 UTC, 2016 стек: cflinuxfs3 buildpack: ruby_buildpack состояние, так как детали диска памяти процессора # 0 работает 08.06.2016, 16:44:07 0,0% 0 из 1G 0 из 1G 

Сопоставление маршрута с приложением

Вы можете указать имя хоста для своего приложения при отправке приложения.Если вы не укажете имя хоста, команда cf push перенаправит ваше приложение на URL-адрес формы APP-NAME.DOMAIN , где APP-NAME - это имя вашего приложения, а DOMAIN - ваше имя по умолчанию. домен.

Для получения информации о сопоставлении маршрута с вашим приложением см. Маршруты и домены.

Чтобы проложить маршрут к приложению:

  1. Войдите в cf CLI, запустив:

      cf войти  
  2. Составить маршрут, запустив:

      cf push APP-NAME --hostname APP-HOSTNAME  

    Где:

    • APP-NAME - это имя приложения.
    • APP-HOSTNAME - имя хоста приложения.

Управление экземплярами услуг, предоставляемых пользователями

В этих разделах описывается, как создать или обновить экземпляр службы.

Создание экземпляра службы

Чтобы создать новый экземпляр службы, используйте команды cf create-user-provided-service или cf cups . Дополнительные сведения см. В разделе create-user-provided-service в справочном руководстве по интерфейсу командной строки Cloud Foundry .

Чтобы создать или обновить экземпляр предоставляемой пользователем службы, необходимо указать основные параметры. Например, для службы базы данных может потребоваться имя пользователя, пароль, хост, порт и имя базы данных.

Эти параметры можно указать следующими способами:

Параметры поставки в интерактивном режиме

Для создания новой услуги с интерактивным вводом параметров:

  1. Войдите в cf CLI, запустив:

      cf войти  
  2. Перечислить параметры в списке, разделенном запятыми, после флага -p .Бега:

      кубиков СЕРВИС -p «ПАРАМЕТР, ВТОРОЙ ПАРАМЕТР, ТРЕТИЙ ПАРАМЕТР»  

    Где:

    • СЕРВИС - это имя службы, которую вы хотите создать.
    • ПАРАМЕТР , ВТОРОЙ ПАРАМЕТР и ТРЕТИЙ ПАРАМЕТР - это такие параметры, как имя пользователя, пароль, хост, порт и имя базы данных.
Параметры поставки в неинтерактивном режиме

Чтобы создать новую услугу при неинтерактивном вводе параметров:

  1. Войдите в cf CLI, запустив:

      cf войти  
  2. Передавать параметры и их значения в виде хэша JSON, заключенного в одинарные кавычки, после тега -p .Бега:

      cf cups SERVICE -p '{"host": "HOSTNAME", "port": "PORT"}'  

    Где:

    • СЕРВИС - это имя службы, которую вы хотите создать.
    • HOSTNAME и PORT - служебные параметры.
Поставка параметров через третье лицо

Для получения инструкций по конкретным службам журналов см. Инструкции по отдельным службам для журналов потокового приложения.

Чтобы создать экземпляр службы, который отправляет данные третьей стороне:

  1. Войти в cf CLI:

      cf войти  
  2. Создайте экземпляр службы, который отправляет данные третьей стороне, запустив:

      cf cups SERVICE -l ТРЕТЬЯ-СТОРОНА-НАЗНАЧЕНИЕ-URL  

    Где:

    • СЕРВИС - это имя службы, которую вы хотите создать.
    • THIRD-PARTY-DESTINATION-URL - это внешний URL-адрес сторонней службы.

Привязка и отмена привязки экземпляров службы

После создания экземпляра службы, предоставляемой пользователем, вы можете:

  • Привяжите службу к приложению с помощью cf bind-service . Дополнительные сведения см. В разделе bind-service в справочном руководстве по интерфейсу командной строки Cloud Foundry .

  • Отмените привязку услуги с помощью cf unbind-service .Дополнительные сведения см. В разделе unbind-service в справочном руководстве по интерфейсу командной строки Cloud Foundry .

  • Переименуйте службу в cf rename-service . Дополнительные сведения см. В разделе rename-service в справочном руководстве по интерфейсу командной строки Cloud Foundry .

  • Удалите службу с помощью cf delete-service . Дополнительные сведения см. В разделе delete-service в справочном руководстве по интерфейсу командной строки Cloud Foundry .

Обновление экземпляра службы

Чтобы обновить один или несколько параметров для существующего экземпляра предоставляемой пользователем службы, используйте cf update-user-provided-service или cf uups .

Для получения дополнительной информации см. Update-user-provided-service в Cloud Foundry CLI Reference Guide .

Примечание: Команда cf uups не обновляет значения параметров, которые вы не предоставили.

Получить коды возврата CLI

Интерфейс командной строки cf использует коды выхода, которые помогают в написании сценариев и подтверждают, что команда успешно выполнена.

Для просмотра кода выхода cf CLI:

  1. Войдите в cf CLI, запустив:

      cf войти  
  2. Чтобы проверить, что вход был успешным, выполните одну из этих команд, в зависимости от вашей ОС:

    • Для Mac OS:

        эхо $?  
    • Для Windows запустите:

        эхо% ERRORLEVEL%  

Если команда выполнена успешно, код выхода - 0 .

Просмотр вывода справки CLI

Команда cf help перечисляет команды интерфейса командной строки cf и краткое описание каждой из них. Дополнительные сведения см. В справке Cloud Foundry CLI Reference Guide .

Чтобы отобразить подробную справку по любой команде cf CLI, добавьте к команде флаг -h .

Пример ниже показывает подробный вывод справки для команды cf delete :

 $ cf удалить -h НАЗВАНИЕ: delete - Удалить приложение ПРИМЕНЕНИЕ: cf удалить APP_NAME [-f -r] НИКНЕЙМЫ: d ПАРАМЕТРЫ: -f Принудительное удаление без подтверждения -r Также удалить все сопоставленные маршруты 
.

Начало работы с cf CLI

Последнее обновление страницы:

В этом разделе описывается настройка и начало работы с интерфейсом командной строки Cloud Foundry (см. CLI).

Обзор

CLI cf является официальным клиентом командной строки для Cloud Foundry. Вы можете использовать cf CLI для управления приложениями, экземплярами служб, организациями, пространствами и пользователями. в вашем окружении.

Необходимое условие

Для выполнения процедур, описанных в этом разделе, необходимо загрузить и установить последнюю версию cf CLI.Для получения дополнительной информации см. Установка интерфейса командной строки Cloud Foundry.

Войти через интерфейс командной строки

Команда cf login использует синтаксис, описанный ниже, для указания целевой конечной точки API, учетных данных для входа, организации и пробела.

Интерфейс командной строки cf запрашивает учетные данные при необходимости. Если вы являетесь участником нескольких организаций или пространств, cf login предложит вам, в какие из них следует войти. В противном случае он автоматически нацеливается на вашу организацию и пространство.

Для входа в cf CLI:

  1. Пробег:

      cf login -a API-URL -u ИМЯ ПОЛЬЗОВАТЕЛЯ -p ПАРОЛЬ -o ORG -s ПРОБЕЛ  

    Где:

    • API-URL - это ваша конечная точка API, URL-адрес Cloud Controller в вашем экземпляре Cloud Foundry.
    • ИМЯ ПОЛЬЗОВАТЕЛЯ - ваше имя пользователя.
    • ПАРОЛЬ - ваш пароль. Cloud Foundry не рекомендует использовать параметр -p , так как он может записать ваш пароль в историю оболочки.
    • ORG - это организация, в которой вы хотите развернуть свои приложения.
    • ПРОСТРАНСТВО - это пространство в организации, где вы хотите развернуть свои приложения.

После успешного входа в систему вы увидите результат, как в примере ниже:

 $ cf логин -a https: // api.example.com -u [email protected] -o example-org -s development Конечная точка API: https://api.example.com Пароль> Аутентификация ... ОК Целевая организация example-org Целевое развитие пространства Конечная точка API: https://api.example.com Пользователь: [email protected] Организация: example-org Космос: разработка 

Войти через API

Вы можете написать сценарий для входа в cf CLI. Это позволяет избежать ручного входа в cf CLI каждый раз, когда вы его используете.

Чтобы написать скрипт для входа:

  1. Настройте свой API, запустив:

      cf api API-URL  

    Где API-URL - ваша конечная точка API, URL-адрес облачного контроллера в вашем экземпляре Cloud Foundry.

    Для получения дополнительных сведений см. Api в справочном руководстве по интерфейсу командной строки Cloud Foundry .

  2. Аутентифицировать, запустив:

      cf auth ПАРОЛЬ ИМЕНИ ПОЛЬЗОВАТЕЛЯ  

    Где:

  3. Настройте таргетинг на свою организацию или пространство, запустив:

      cf target -o ORG -s ПРОБЕЛ  

    Где:

После входа в систему cf CLI сохраняет конфигурацию .json , который содержит конечную точку API, организацию, значения пробелов и токен доступа.

Если вы измените эти параметры, файл config.json будет соответствующим образом обновлен.

По умолчанию, config.json находится в каталоге ~ / .cf . Вы можете переместить файл config.json , используя переменную среды CF_HOME .

Локализация CLI

Интерфейс командной строки cf переводит вывод терминала на выбранный вами язык.Язык по умолчанию - en-US .

Интерфейс командной строки cf поддерживает следующие языки:

  • Китайский (упрощенный): zh-Hans
  • Китайский (традиционный): zh-Hant
  • Английский: en-US
  • французский: fr-FR
  • Немецкий: de-DE
  • итальянский: it-IT
  • Японский: ja-JP
  • корейский: ko-KR
  • Португальский (Бразилия): pt-BR
  • Испанский: es-ES

Для получения дополнительной информации см. Config в Справочном руководстве по интерфейсу командной строки Cloud Foundry .

Примечание: Локализация с помощью cf config --locale влияет только на сообщения, генерируемые cf CLI.

Для установки языка интерфейса командной строки cf:

  1. Войти в cf CLI:

      cf войти  
  2. Пробег:

      cf config --locale LANGUAGE  

    Где LANGUAGE - это код языка, который вы хотите установить.

  3. Подтвердите изменение языка, запустив:

      cf help  

    Команда возвращает вывод, аналогичный приведенному ниже примеру:

     $ cf help НОМЕР: cf - Uma ferramenta de linha de comando para intergir com Cloud Foundry USO: cf [opções globais] comando [arguments...] [opções de comando] ВЕРШО: 6.14.1 ... 

Управление пользователями и ролями

Интерфейс командной строки cf включает команды, которые выводят список пользователей и назначают роли в организациях и пространствах.

Список пользователей

Чтобы перечислить всех пользователей в организации или пространстве:

  1. Войти в cf CLI:

      cf войти  
  2. Выполните одну из этих команд:

      cf org-users  
    • Чтобы вывести список пользователей пространства, введите:
      cf space-users  

Команда возвращает вывод, аналогичный приведенному ниже примеру:

 $ cf org-users example-org Получение пользователей в org example-org как username @ example.ком ... МЕНЕДЖЕР ОРГАНИЗАЦИИ [email protected] БИЛЛИНГ-МЕНЕДЖЕР [email protected] [email protected] ОРГАНИЗАЦИОННЫЙ АУДИТОР [email protected] 

Для получения дополнительной информации см. Org-users и space-users в Cloud Foundry CLI Reference Guide .

Управление ролями

Вы используете перечисленные ниже команды для управления ролями в cf CLI. Эти команды требуют прав администратора и принимают имя пользователя, org или пространство и роль в качестве аргументов:

  • cf set-org-role
    Для получения дополнительной информации см. Set-org-role в справочном руководстве Cloud Foundry CLI .

  • cf unset-org-role
    Для получения дополнительной информации см. Unset-org-role в Справочном руководстве Cloud Foundry CLI .

  • cf set-space-role
    Для получения дополнительной информации см. Set-space-role в справочном руководстве Cloud Foundry CLI .

  • cf unset-space-role
    Для получения дополнительной информации см. Unset-space-role в Справочном руководстве Cloud Foundry CLI .

Доступные роли:

  • OrgManager
  • BillingManager
  • ОргАудитор
  • SpaceManager
  • SpaceDeveloper
  • SpaceAuditor

Дополнительные сведения о ролях пользователей см. В разделе Организации, пространства, роли и разрешения.

В приведенном ниже примере показан вывод командной строки cf для назначения роли Org Manager пользователю внутри организации:

 $ cf set-org-role [email protected] example-org OrgManager Назначение роли OrgManager пользователю [email protected] в org example-org как [email protected] ... ОК 

Примечание: Если вы не являетесь администратором, вы увидите это сообщение при попытке выполнить следующие команды: код ошибки: 10003, сообщение: у вас нет прав для выполнения запрошенного действия

Управление ролями для пользователей с одинаковыми именами пользователей из нескольких источников

Если имя пользователя соответствует нескольким учетным записям из разных пользовательских хранилищ, таких как внутреннее хранилище UAA и внешнее хранилище SAML или LDAP, команды cf set-org-role и cf unset-org-role выше возвращают эта ошибка:

 Пользователь существует из нескольких источников.Укажите источник для запрашиваемого пользователя: «uaa», «other» 

Чтобы устранить эту двусмысленность, вы можете создать команду curl , которая использует API для выполнения желаемой функции управления ролями. Пример см. В разделе «Связать аудитора с организацией по имени пользователя» в документации по Cloud Foundry API.

Нажмите приложение

В этих разделах описывается, как использовать команду cf push для отправки нового приложения или синхронизации изменений в существующем приложении.

Для получения дополнительной информации см. Push в справочном руководстве по интерфейсу командной строки Cloud Foundry .

Отправьте новое приложение или отправьте изменения в приложение

Чтобы отправить приложение:

  1. Войдите в cf CLI, запустив:

      cf войти  
  2. Перейдите в каталог приложения.

  3. Отправить новое приложение или внести изменения в приложение, запустив:

      cf push APP-NAME  

    Где APP-NAME - это имя приложения.

Отправка приложения с помощью манифеста

Вы можете указать путь к файлу манифеста при отправке приложения.Файл манифеста может включать в себя такую ​​информацию, как имя приложения, ограничение на диск и количество экземпляров. Вы можете использовать файл манифеста вместо того, чтобы добавлять флаги в команду cf push .

cf push по умолчанию находит файл manifest.yml в текущем рабочем каталоге. Или вы можете указать путь к манифесту с помощью флага -f .

Для получения дополнительной информации о флаге -f см. Push в справочном руководстве Cloud Foundry CLI .

Примечание: Когда вы указываете имя приложения в командной строке, cf push использует это имя приложения независимо от того, есть ли другое имя приложения в манифесте. Если манифест описывает несколько приложений, вы можете отправить одно приложение, указав его имя в командной строке; cf CLI не подталкивает остальных. Используйте эти варианты поведения для тестирования.

Отправка приложения с помощью пакета сборки

Вы можете указать пакет сборки при отправке приложения с флагом -b .Если вы используете флаг -b для указания пакета сборки, приложение останется постоянно связанным с этим пакетом сборки. Чтобы использовать приложение с другим пакетом сборки, вы должны удалить приложение, а затем снова нажать на него.

Дополнительные сведения о доступных пакетах сборки см. В разделе Пакеты сборки.

В приведенном ниже примере приложение под названием awesome-app перемещается по URL-адресу http://awesome-app.example.com и указывает пакет сборки Ruby с флагом -b :

 $ cf push awesome-app -b ruby_buildpack Создание приложения awesome-app в org example-org / space development как username @ example.ком ... ОК Создание маршрута awesome-app.example.com ... ОК ... 1 из 1 запущенных экземпляров Приложение запущено ... запрошенное состояние: запущено экземпляры: 1/1 использование: 1 Гб x 1 экземпляр URL: awesome-app.example.com последняя загрузка: среда, 8 июня, 23:43:15 UTC, 2016 стек: cflinuxfs3 buildpack: ruby_buildpack состояние, так как детали диска памяти процессора # 0 работает 08.06.2016, 16:44:07 0,0% 0 из 1G 0 из 1G 

Сопоставление маршрута с приложением

Вы можете указать имя хоста для своего приложения при отправке приложения.Если вы не указываете имя хоста, команда cf push перенаправляет ваше приложение на URL-адрес формы APP-NAME.DOMAIN , где APP-NAME - это имя вашего приложения, а DOMAIN - ваше имя по умолчанию. домен.

Для получения информации о сопоставлении маршрута с вашим приложением см. Маршруты и домены.

Чтобы проложить маршрут к приложению:

  1. Войдите в cf CLI, запустив:

      cf войти  
  2. Нанесите на карту маршрут, запустив:

      cf push APP-NAME --hostname APP-HOSTNAME  

    Где:

    • APP-NAME - это имя приложения.
    • APP-HOSTNAME - имя хоста приложения.

Управление экземплярами услуг, предоставляемых пользователями

В этих разделах описывается, как создать или обновить экземпляр службы.

Создание экземпляра службы

Чтобы создать новый экземпляр службы, используйте команды cf create-user-provided-service или cf cups . Дополнительные сведения см. В разделе create-user-provided-service в справочном руководстве по интерфейсу командной строки Cloud Foundry .

Чтобы создать или обновить экземпляр предоставляемой пользователем службы, необходимо указать основные параметры. Например, для службы базы данных может потребоваться имя пользователя, пароль, хост, порт и имя базы данных.

Эти параметры можно указать следующими способами:

Параметры поставки в интерактивном режиме

Для создания новой услуги с интерактивным вводом параметров:

  1. Войдите в cf CLI, запустив:

      cf войти  
  2. Перечислить параметры в списке, разделенном запятыми, после флага -p .Бега:

      cf cups SERVICE -p «ПАРАМЕТР, ВТОРОЙ ПАРАМЕТР, ТРЕТИЙ ПАРАМЕТР»  

    Где:

    • СЕРВИС - это имя службы, которую вы хотите создать.
    • ПАРАМЕТР , ВТОРОЙ ПАРАМЕТР и ТРЕТИЙ ПАРАМЕТР - это такие параметры, как имя пользователя, пароль, хост, порт и имя базы данных.
Параметры поставки в неинтерактивном режиме

Чтобы создать новую услугу с неинтерактивным вводом параметров:

  1. Войдите в cf CLI, запустив:

      cf войти  
  2. Передавать параметры и их значения в виде хэша JSON, заключенного в одинарные кавычки, после тега -p .Бега:

      cf cups SERVICE -p '{"host": "HOSTNAME", "port": "PORT"}'  

    Где:

    • СЕРВИС - это имя службы, которую вы хотите создать.
    • HOSTNAME и PORT - служебные параметры.
Поставка параметров через третье лицо

Для получения инструкций по конкретным службам журналов см. Инструкции по отдельным службам для журналов потокового приложения.

Для создания экземпляра службы, отправляющего данные третьей стороне:

  1. Войти в cf CLI:

      cf войти  
  2. Создайте экземпляр службы, который отправляет данные третьей стороне, запустив:

      cf cups SERVICE -l ТРЕТЬЯ-СТОРОНА-НАЗНАЧЕНИЕ-URL  

    Где:

    • СЕРВИС - это имя службы, которую вы хотите создать.
    • THIRD-PARTY-DESTINATION-URL - это внешний URL-адрес сторонней службы.

Привязать и отменить привязку экземпляров службы

После создания экземпляра службы, предоставляемой пользователем, вы можете:

  • Привяжите службу к приложению с помощью cf bind-service . Дополнительные сведения см. В разделе bind-service в справочном руководстве по интерфейсу командной строки Cloud Foundry .

  • Отмените привязку услуги с помощью cf unbind-service .Дополнительные сведения см. В разделе unbind-service в справочном руководстве по интерфейсу командной строки Cloud Foundry .

  • Переименуйте службу в cf rename-service . Дополнительные сведения см. В разделе rename-service в справочном руководстве по интерфейсу командной строки Cloud Foundry .

  • Удалите службу с помощью cf delete-service . Дополнительные сведения см. В разделе delete-service в справочном руководстве по интерфейсу командной строки Cloud Foundry .

Обновление экземпляра службы

Чтобы обновить один или несколько параметров для существующего экземпляра предоставляемой пользователем службы, используйте cf update-user-provided-service или cf uups .

Для получения дополнительной информации см. Update-user-provided-service в Cloud Foundry CLI Reference Guide .

Примечание: Команда cf uups не обновляет значения параметров, которые вы не предоставили.

Получить коды возврата CLI

Интерфейс командной строки cf использует коды выхода, которые помогают в написании сценариев и подтверждают, что команда успешно выполнена.

Для просмотра кода выхода cf CLI:

  1. Войдите в cf CLI, запустив:

      cf войти  
  2. Чтобы проверить, что вход был успешным, выполните одну из этих команд в зависимости от вашей ОС:

    • Для Mac OS:

        эхо $?  
    • Для Windows запустите:

        эхо% ERRORLEVEL%  

Если команда завершится успешно, код выхода - 0 .

Просмотр вывода справки CLI

Команда cf help перечисляет команды интерфейса командной строки cf и краткое описание каждой из них. Дополнительные сведения см. В справке Cloud Foundry CLI Reference Guide .

Чтобы отобразить подробную справку по любой команде cf CLI, добавьте к команде флаг -h .

В приведенном ниже примере показан подробный вывод справки для команды cf delete :

 $ cf удалить -h НАЗВАНИЕ: delete - Удалить приложение ПРИМЕНЕНИЕ: cf удалить APP_NAME [-f -r] НИКНЕЙМЫ: d ПАРАМЕТРЫ: -f Принудительное удаление без подтверждения -r Также удалить все сопоставленные маршруты 
Создайте запрос на перенос или поднимите проблему с источником для этой страницы в GitHub .

Смотрите также