Какой файл содержит настройки, применимые к текущему сайту
Обновлено: 02.07.2024
В этом разделе подробно рассказывается о Spring Boot. Здесь вы можете узнать об основных функциях, которые вы, возможно, захотите использовать и настроить. Если вы еще этого не сделали, вы можете прочитать разделы "getting-started.html" и "using.html", чтобы иметь хорошее представление об основах.
1. Приложение Spring
При запуске приложения вы должны увидеть что-то вроде следующего:
По умолчанию отображаются сообщения журнала INFO, включая некоторые важные сведения о запуске, такие как пользователь, запустивший приложение. Если вам нужен уровень журнала, отличный от INFO, вы можете установить его, как описано в разделе «Уровни журнала». Версия приложения определяется по версии реализации из пакета основного класса приложения. Ведение журнала информации о запуске можно отключить, установив для spring.main.log-startup-info значение false . Это также отключит регистрацию активных профилей приложения.
| Чтобы добавить дополнительное ведение журнала во время запуска, вы можете переопределить logStartupInfo(boolean) в подклассе SpringApplication . |
1.1. Ошибка запуска
Если ваше приложение не запускается, зарегистрированные специалисты FailureAnalyzer могут предоставить специальное сообщение об ошибке и конкретные действия по устранению проблемы. Например, если вы запускаете веб-приложение на порту 8080, а этот порт уже используется, вы должны увидеть примерно следующее сообщение:
| Spring Boot предоставляет множество реализаций FailureAnalyzer, и вы можете добавить свои собственные. |
Если ни один анализатор отказов не может обработать исключение, вы все равно можете отобразить полный отчет об условиях, чтобы лучше понять, что пошло не так. Для этого вам необходимо включить свойство отладки или включить ведение журнала DEBUG для org.springframework.boot.autoconfigure.logging.ConditionEvaluationReportLoggingListener .
Например, если вы запускаете приложение с помощью java -jar , вы можете включить свойство отладки следующим образом:
1.2. Ленивая инициализация
Недостаток отложенной инициализации заключается в том, что она может задержать обнаружение проблемы с приложением. Если неправильно сконфигурированный bean-компонент инициализируется лениво, сбой больше не произойдет во время запуска, и проблема станет очевидной только при инициализации bean-компонента. Также необходимо позаботиться о том, чтобы у JVM было достаточно памяти для размещения всех bean-компонентов приложения, а не только тех, которые инициализируются во время запуска. По этим причинам отложенная инициализация не включена по умолчанию, и перед включением отложенной инициализации рекомендуется выполнить точную настройку размера кучи JVM.
В этой статье описывается реестр Windows и содержится информация о том, как его редактировать и создавать резервные копии.
Относится к: Windows 10 — все выпуски, Windows Server 2012 R2
Исходный номер базы знаний: 256986
Описание реестра
В пятом издании Microsoft Computer Dictionary реестр определяется как:
Центральная иерархическая база данных, используемая в Windows 98, Windows CE, Windows NT и Windows 2000 для хранения информации, необходимой для настройки системы для одного или нескольких пользователей, приложений и аппаратных устройств.
Реестр содержит информацию, на которую Windows постоянно ссылается во время работы, например, профили для каждого пользователя, приложения, установленные на компьютере, и типы документов, которые каждый из них может создавать, настройки листа свойств для папок и значков приложений, какое аппаратное обеспечение установлено на компьютере. система и используемые порты.
Реестр заменяет большинство текстовых файлов .ini, которые используются в Windows 3.x и файлах конфигурации MS-DOS, таких как Autoexec.bat и Config.sys. Хотя реестр является общим для нескольких операционных систем Windows, между ними есть некоторые различия. Куст реестра — это группа ключей, подразделов и значений в реестре, которая имеет набор вспомогательных файлов, содержащих резервные копии своих данных. Вспомогательные файлы для всех кустов, кроме HKEY_CURRENT_USER, находятся в папке % SystemRoot%\System32\Config в Windows NT 4.0, Windows 2000, Windows XP, Windows Server 2003 и Windows Vista. Вспомогательные файлы для HKEY_CURRENT_USER находятся в папке %SystemRoot%\Profiles\Username. Расширения имен файлов в этих папках указывают тип содержащихся в них данных. Кроме того, отсутствие расширения может иногда указывать на тип данных, которые они содержат.
| куст реестра | Поддерживаемые файлы |
|---|---|
| HKEY_LOCAL_MACHINE\SAM | Sam, Sam.log, Sam.sav |
| HKEY_LOCAL_MACHINE\Security | Security, Security.log, Security.sav |
| HKEY_LOCAL_MACHINE\Software | Software, Software.log, Software.sav |
| HKEY_LOCAL_MACHINE\System | Система, System.alt, Система.log, System.sav |
| HKEY_CURRENT_CONFIG | System, System.alt, System.log, System.sav, Ntuser.dat, Ntuser.dat.log |
| HKEY_USERS\DEFAULT | Default, Default.log, Default.sav |
В Windows 98 файлы реестра называются User.dat и System.dat. В Windows Millennium Edition файлы реестра называются Classes.dat, User.dat и System.dat.
Функции безопасности в Windows позволяют администратору контролировать доступ к разделам реестра.
В следующей таблице перечислены предопределенные клавиши, используемые системой. Максимальный размер имени ключа — 255 символов.
| Папка/предопределенный ключ | Описание |
|---|---|
| HKEY_CURRENT_USER | Содержит корневую информацию о конфигурации для пользователя, который в данный момент находится в системе. Здесь хранятся папки пользователя, цвета экрана и настройки панели управления. Эта информация связана с профилем пользователя. Этот ключ иногда обозначается как HKCU. |
| HKEY_USERS | Содержит все активно загруженные профили пользователей на компьютере. HKEY_CURRENT_USER является подразделом HKEY_USERS. HKEY_USERS иногда обозначается как HKU. |
| HKEY_LOCAL_MACHINE | Содержит информацию о конфигурации, относящуюся к компьютеру (для любого пользователя). Этот ключ иногда обозначается как HKLM. |
| HKEY_CLASSES_ROOT | Является подразделом HKEY_LOCAL_MACHINE\Software . Информация, хранящаяся здесь, гарантирует, что при открытии файла с помощью проводника Windows откроется нужная программа. Этот ключ иногда обозначается как HKCR. Начиная с Windows 2000, эта информация хранится в ключах HKEY_LOCAL_MACHINE и HKEY_CURRENT_USER. Раздел HKEY_LOCAL_MACHINE\Software\Classes содержит настройки по умолчанию, которые могут применяться ко всем пользователям на локальном компьютере. Раздел HKEY_CURRENT_USER\Software\Classes содержит параметры, которые переопределяют параметры по умолчанию и применяются только к интерактивному пользователю. Раздел HKEY_CLASSES_ROOT предоставляет представление реестра, объединяющее информацию из этих двух источников. HKEY_CLASSES_ROOT также обеспечивает это объединенное представление для программ, разработанных для более ранних версий Windows. Чтобы изменить настройки интерактивного пользователя, необходимо внести изменения в HKEY_CURRENT_USER\Software\Classes, а не в HKEY_CLASSES_ROOT. Чтобы изменить настройки по умолчанию, необходимо внести изменения в разделе HKEY_LOCAL_MACHINE\Software\Classes. Если вы записываете ключи в раздел HKEY_CLASSES_ROOT, система сохраняет информацию в разделе HKEY_LOCAL_MACHINE\Software\Classes. Если вы записываете значения в ключ в HKEY_CLASSES_ROOT, а ключ уже существует в HKEY_CURRENT_USER\Software\Classes, система сохранит информацию там, а не в HKEY_LOCAL_MACHINE\Software\Classes. |
| Содержит информацию о профиле оборудования, который используется локальным компьютером при запуске системы. |
Реестр в 64-разрядных версиях Windows XP, Windows Server 2003 и Windows Vista разделен на 32-разрядные и 64-разрядные ключи. Многие из 32-битных ключей имеют те же имена, что и их 64-битные аналоги, и наоборот. 64-разрядная версия редактора реестра по умолчанию, входящая в состав 64-разрядных версий Windows XP, Windows Server 2003 и Windows Vista, отображает 32-разрядные ключи в узле HKEY_LOCAL_MACHINE\Software\WOW6432Node. Дополнительные сведения о том, как просматривать реестр в 64-разрядных версиях Windows, см. в разделе Как просмотреть системный реестр в 64-разрядных версиях Windows.
В следующей таблице перечислены типы данных, которые в настоящее время определены и используются Windows. Максимальный размер имени значения следующий:
- Windows Server 2003, Windows XP и Windows Vista: 16 383 символа.
- Windows 2000: 260 символов ANSI или 16 383 символа Unicode.
- Windows Millennium Edition/Windows 98/Windows 95: 255 символов.
Длинные значения (более 2048 байт) должны храниться в виде файлов с именами файлов, сохраненными в реестре. Это помогает реестру работать эффективно. Максимальный размер значения следующий:
- Windows NT 4.0/Windows 2000/Windows XP/Windows Server 2003/Windows Vista: Доступная память
- Windows Millennium Edition/Windows 98/Windows 95: 16 300 байт.
Существует ограничение в 64 КБ на общий размер всех значений ключа.
| Имя | Тип данных | Описание |
|---|---|---|
| Двоичное значение | REG_BINARY | Необработанные двоичные данные. Большая часть информации о компонентах оборудования хранится в виде двоичных данных и отображается в редакторе реестра в шестнадцатеричном формате. |
| Значение DWORD | REG_DWORD | Данные, представленные числом длиной 4 байта (32-разрядное целое число).Многие параметры драйверов устройств и служб относятся к этому типу и отображаются в редакторе реестра в двоичном, шестнадцатеричном или десятичном формате. Связанные значения: DWORD_LITTLE_ENDIAN (младший байт находится по младшему адресу) и REG_DWORD_BIG_ENDIAN (младший значащий байт находится по старшему адресу). |
| Расширяемое строковое значение | REG_EXPAND_SZ | Строка данных переменной длины. Этот тип данных включает переменные, которые разрешаются, когда программа или служба использует данные. |
| Многострочное значение | REG_MULTI_SZ | Многократная строка. К этому типу обычно относятся значения, содержащие списки или несколько значений в удобной для чтения форме. Записи разделяются пробелами, запятыми или другими знаками. |
| String Value | REG_SZ | Текстовая строка фиксированной длины. |
| Двоичное значение | REG_RESOURCE_LIST | Серия вложенных массивов, предназначенных для хранения списка ресурсов, используемых оборудованием. драйвер устройства или одно из физических устройств, которыми он управляет. Эти данные обнаруживаются и записываются системой в дерево \ResourceMap и отображаются в редакторе реестра в шестнадцатеричном формате в виде двоичного значения. |
| Двоичное значение | REG_RESOURCE_REQUIREMENTS_LIST | Серия вложенных массивов, предназначенных для хранения списка возможных аппаратных ресурсов драйвера устройства, которые может использовать драйвер или одно из управляемых им физических устройств. Система записывает часть этого списка в дерево \ResourceMap. Эти данные обнаруживаются системой и отображаются в редакторе реестра в шестнадцатеричном формате в виде двоичного значения. |
| Двоичное значение | REG_FULL_RESOURCE_DESCRIPTOR | < td> Ряд вложенных массивов, предназначенных для хранения списка ресурсов, используемых физическим аппаратным устройством. Эти данные обнаруживаются и записываются системой в дерево \HardwareDescription и отображаются в редакторе реестра в шестнадцатеричном формате в виде двоичного значения.|
| Нет | REG_NONE | Данные без определенного типа. Эти данные записываются в реестр системой или приложениями и отображаются в редакторе реестра в шестнадцатеричном формате в виде двоичного значения |
| Link | REG_LINK | Строка Unicode, обозначающая символическую ссылку. |
| Значение QWORD | REG_QWORD | Данные, представленные числом, которое представляет собой 64-битное целое число. Эти данные отображаются в редакторе реестра как двоичное значение и впервые появились в Windows 2000. |
Создать резервную копию реестра
Перед редактированием реестра экспортируйте разделы реестра, которые вы планируете редактировать, или создайте резервную копию всего реестра. В случае возникновения проблемы вы можете выполнить действия, описанные в разделе «Восстановление реестра», чтобы восстановить реестр в его предыдущее состояние. Для резервного копирования всего реестра используйте утилиту резервного копирования для резервного копирования состояния системы. Состояние системы включает реестр, регистрационную базу данных классов COM+ и загрузочные файлы. Дополнительные сведения об использовании утилиты резервного копирования для резервного копирования состояния системы см. в следующих статьях:
Редактировать реестр
Чтобы изменить данные реестра, программа должна использовать функции реестра, определенные в функциях реестра.
Администраторы могут изменять реестр с помощью редактора реестра (Regedit.exe или Regedt32.exe), групповой политики, системной политики, файлов реестра (.reg) или запуска сценариев, таких как файлы сценариев VisualBasic.
Использовать пользовательский интерфейс Windows
Мы рекомендуем использовать пользовательский интерфейс Windows для изменения настроек системы, а не редактировать реестр вручную. Однако иногда редактирование реестра может быть лучшим способом решения проблемы с продуктом. Если проблема задокументирована в базе знаний Майкрософт, будет доступна статья с пошаговыми инструкциями по редактированию реестра для этой проблемы. Мы рекомендуем точно следовать этим инструкциям.
Использовать редактор реестра
При неправильном изменении реестра с помощью редактора реестра или другого метода могут возникнуть серьезные проблемы. Эти проблемы могут потребовать переустановки операционной системы. Майкрософт не может гарантировать, что эти проблемы могут быть решены. Вносите изменения в реестр на свой страх и риск.
Вы можете использовать редактор реестра для выполнения следующих действий:
- Найти поддерево, ключ, подраздел или значение
- Добавить подраздел или значение
- Изменить значение
- Удалить подраздел или значение
- Переименовать подраздел или значение
В области навигации редактора реестра отображаются папки. Каждая папка представляет собой предопределенный ключ на локальном компьютере. При доступе к реестру удаленного компьютера отображаются только два предопределенных ключа: HKEY_USERS и HKEY_LOCAL_MACHINE.
Использовать групповую политику
Консоль управления Microsoft (MMC) содержит инструменты администрирования, которые можно использовать для администрирования сетей, компьютеров, служб и других системных компонентов.Оснастка MMC групповой политики позволяет администраторам определять параметры политики, которые применяются к компьютерам или пользователям. Вы можете реализовать групповую политику на локальных компьютерах с помощью оснастки локальной групповой политики MMC, Gpedit.msc. Вы можете реализовать групповую политику в Active Directory с помощью оснастки MMC «Пользователи и компьютеры Active Directory». Дополнительные сведения об использовании групповой политики см. в разделах справки соответствующей оснастки MMC групповой политики.
Использовать файл регистрационных записей (.reg)
Создайте файл регистрационных записей (.reg), содержащий изменения реестра, а затем запустите файл .reg на компьютере, на котором вы хотите внести изменения. Вы можете запустить файл .reg вручную или с помощью сценария входа в систему. Дополнительные сведения см. в разделе Добавление, изменение или удаление подразделов и значений реестра с помощью файла регистрационных записей (.reg).
Использовать хост сценариев Windows
Узел сценариев Windows позволяет запускать сценарии VBScript и JScript непосредственно в операционной системе. Вы можете создавать файлы VBScript и JScript, которые используют методы Windows Script Host для удаления, чтения и записи ключей и значений реестра. Дополнительные сведения об этих методах см. на следующих веб-сайтах Microsoft:
Использовать инструментарий управления Windows
Инструментарий управления Windows (WMI) является компонентом операционной системы Microsoft Windows и реализацией Microsoft управления предприятием через Интернет (WBEM). WBEM — это отраслевая инициатива по разработке стандартной технологии доступа к управленческой информации в корпоративной среде. Вы можете использовать WMI для автоматизации административных задач (таких как редактирование реестра) в корпоративной среде. Вы можете использовать WMI в языках сценариев, которые имеют движок в Windows и обрабатывают объекты Microsoft ActiveX. Вы также можете использовать утилиту командной строки WMI (Wmic.exe) для изменения реестра Windows.
Использовать консольный инструмент реестра для Windows
Для редактирования реестра можно использовать утилиту Console Registry Tool для Windows (Reg.exe). Чтобы получить справку по инструменту Reg.exe, введите reg /? в командной строке и нажмите кнопку ОК.
Восстановить реестр
Чтобы восстановить реестр, используйте соответствующий метод.
Способ 1. Восстановите ключи реестра
Чтобы восстановить экспортированные подразделы реестра, дважды щелкните файл Registration Entries (.reg), который вы сохранили в разделе Экспорт подразделов реестра. Или вы можете восстановить весь реестр из резервной копии. Дополнительные сведения о том, как восстановить весь реестр, см. в разделе Способ 2. Восстановление всего реестра далее в этой статье.
Способ 2: восстановить весь реестр
Чтобы восстановить весь реестр, восстановите состояние системы из резервной копии. Дополнительные сведения о том, как восстановить состояние системы из резервной копии, см. в разделе Как использовать резервное копирование для защиты данных и восстановления файлов и папок на компьютере в Windows XP и Windows Vista.
При резервном копировании состояния системы также создаются обновленные копии файлов реестра в папке %SystemRoot%\Repair.
Ссылки
Для получения дополнительной информации посетите следующие веб-сайты:
Каталог протестированных продуктов Windows Server — это справочник по продуктам, которые были протестированы на совместимость с Windows Server.
Диспетчер защиты данных (DPM) — это ключевой член семейства продуктов управления Microsoft System Center, который помогает ИТ-специалистам управлять своей средой Windows. DPM — это новый стандарт резервного копирования и восстановления Windows, который обеспечивает непрерывную защиту данных для приложений и файловых серверов Microsoft, использующих интегрированные диски и ленточные носители. Дополнительные сведения о резервном копировании и восстановлении реестра см. в разделе Резервное копирование и восстановление реестра в Windows XP и Windows Vista.
При запуске R он по умолчанию создает файл .Rprofile, если он существует. Это позволяет автоматически настраивать параметры R в соответствии с вашими повседневными потребностями. Например, вы можете установить репозиторий CRAN по умолчанию ( options("repos") ), чтобы вам не приходилось выбирать его каждый раз при установке пакета.
Пакет запуска расширяет стандартный процесс запуска R, позволяя поместить несколько сценариев запуска в общий каталог '.Rprofile.d' и получить их все в процессе запуска R. Таким образом, у вас может быть один файл для настройки репозитория CRAN по умолчанию, а другой — для настройки ваших личных параметров инструментов разработки. Точно так же вы можете использовать каталог Renviron.d с несколькими файлами, определяющими различные переменные среды. Например, один файл может определять переменную среды LANGUAGE, а другой файл может содержать ваш закрытый ключ GITHUB_PAT. Преимущества этого подхода заключаются в том, что он дает лучший обзор при перечислении файлов, упрощает обмен определенными настройками (= определенными файлами) с другими пользователями и позволяет вам сохранять определенные файлы полностью конфиденциальными (путем установки прав доступа к файлам таким образом). только вы можете получить доступ к этим настройкам).
Как работает процесс запуска R
При запуске R выполняется следующая зависимая от пользователя настройка:
Обрабатывается первый файл .Renviron, найденный в пути поиска при запуске R. Путь поиска (по порядку): (i) Sys.getenv("R_ENVIRON_USER") , (ii) ./.Renviron и (iii) ~/.Renviron . Формат этого файла — один оператор ENV_VAR=VALUE на строку, ср. ?.Ренвирон. ПРИМЕЧАНИЕ. Некоторые переменные среды должны быть установлены уже на этом шаге, чтобы R мог их подтвердить, т. е. слишком поздно устанавливать некоторые из них на шаге 2 и шаге 3. ниже.
Обрабатывается первый файл .Rprofile, найденный в пути поиска при запуске R. Путь поиска (по порядку): (i) Sys.getenv("R_PROFILE_USER") , (ii) ./.Rprofile и (iii) ~/.Rprofile . Формат этого файла должен быть допустимым сценарием R (с символом новой строки в конце), ср. ?.Rprofile .
Если файл .Rprofile (на шаге 2) вызывает startup::startup(), то также происходит следующее:
а. Обрабатывается первый каталог Renviron.d в пути поиска при запуске R. Путь поиска (по порядку): (i) paste0(Sys.getenv("R_ENVIRON_USER"), ".d") , (ii) ./.Renviron.d , (iii) ~/.Renviron.d и (iv) /Renviron.d, где соответствует tools::R_user_dir("startup", which = "config"), например $/R/запуск. Формат этих файлов должен быть таким же, как и для .Renviron. ПРИМЕЧАНИЕ. Некоторые переменные среды должны быть установлены уже на шаге 1 выше, чтобы они были подтверждены R.
б. Установлен набор удобных опций R, которые можно использовать на шаге 3c. Их имена имеют префикс startup.session. – подробности см. в ?startup::startup_session_options.
<р>в. Обрабатывается первый каталог Rprofile.d, найденный в пути поиска при запуске R. Путь поиска (по порядку): (i) paste0(Sys.getenv("R_PROFILE_USER"), ".d") , (ii) ./.Rprofile.d , (iii) ~/.Rprofile.d и (iv) /Rprofile.d . Формат этих файлов должен быть таким же, как у .Rprofile , то есть они должны быть допустимыми скриптами R.д. Если вышеперечисленных ошибок не возникнет, пакет запуска будет выгружен, не оставив после себя никаких следов, за исключением параметров R startup.session.*, установленных на шаге 3b, которые будут стерты, если startup::startup() вызывается с параметром keep = НУЛЕВОЕ .
Все соответствующие файлы в каталогах «Renviron.d» и «Rprofile.d», включая те, которые рекурсивно найдены в их подкаталогах, будут обработаны (в лексикографическом порядке, отсортированном по локали C). Нет никаких ограничений на имена файлов (кроме тех, которые игнорируются, как описано ниже). Однако для файлов Rprofile.d мы рекомендуем использовать расширение имени файла *.R, чтобы указать, что файлы являются обычными R-скриптами. Для файлов 'Renviron.d' мы рекомендуем использовать файлы без расширений (или *.Renviron для уточнения). Во избежание недоразумений не используйте расширение *.R для файлов 'Renviron.d', поскольку они сами по себе не являются скриптом R (о чем вас могут предупредить некоторые редакторы).
Файлы с расширениями *.txt, *.md и *~ игнорируются, а также любые файлы с именами .Rhistory, .RData и .DS_Store. Каталоги с именем __MACOSX и их содержимое игнорируются. Файлы и каталоги, имена которых начинаются с двух точек ( .. ), игнорируются, например ~/.Rprofile.d/..мои-тесты/ .
Установка
После установки пакетов запуска (см. инструкции в конце) позвоните
один раз. Это добавит
в ваш ~/.Rprofile . Файл будет создан, если отсутствует. Это также создаст каталоги ~/.Renviron.d/ и ~/.Rprofile.d/, если они отсутствуют. Чтобы найти расположение этой папки в Windows, используйте normalizePath("~") — она часто находится в папке C:\Users\Alice\Documents\ .
В качестве альтернативы описанной выше настройке установки вы можете просто вручную добавить эту строку в файл ~/.Rprofile. Причина использования tryCatch(. error = . ) заключается в том, что автозагрузка не установлена, и вы пытаетесь ее установить, например. после обновления R до новой основной версии. Без try() R не сможет установить пакет запуска (или любой другой пакет), потому что сценарий запуска профиля R выдает ошибку, жалуясь на то, что запуск недоступен.
Использование
Для отладки процесса запуска используйте startup::startup(debug = TRUE) или установите переменную среды R_STARTUP_DEBUG=TRUE , например в Linux вы можете сделать
В MS Windows вы можете сделать следующее:
При этом во время запуска будут создаваться сообщения с отметками времени, в которых указывается, какие файлы включены, а также сведения о файлах и их изменениях.
Условные имена файлов и каталогов
Если имя файла состоит из спецификации =, то этот файл будет включен/использован только в том случае, если спецификация выполнена (в текущей системе с текущей настройкой R). Например, файл ~/.Rprofile.d/os=windows.R будет игнорироваться, если только startup::sysinfo()$os == "windows" , т. е. сеанс R не запущен в системе Windows.
Следующие ключи startup::sysinfo() доступны для условного включения файлов по их путям:
- dirname - (символ) имя текущего рабочего каталога (= basename(getwd()) )
- gui — (символ) графический интерфейс пользователя (= .Platform$GUI )
- имя_узла — (символ) имя хоста (= Sys.info()[["имя_узла"]] )
- machine — (символ) тип машины (= Sys.info()[["machine"]] )
- os - (символ) операционная система (= .Platform$OS.type )
- sysname — (символ) имя системы (= Sys.info()[["sysname"]] )
- user – (символ) имя пользователя (= Sys.info()[["user"]] )
- interactive – (логично) независимо от того, работает ли R в интерактивном режиме или нет (= Interactive() )
- ess — (логично) независимо от того, работает ли R в Emacs Speaks Statistics (ESS) или нет
- pqr — (логично) независимо от того, работает ли pqR ("довольно быстрая версия R") или нет
- радиан — (логично) использовать ли R в радианах (ранее известные как "артишок" и "рис") или нет
- microsoftr — (логично) независимо от того, работает ли R в Microsoft R Open или нет
- rstudio — (логично) запускает ли R в консоли RStudio или нет
- rstudioterm — (логично) независимо от того, работает ли R в терминале RStudio или нет
- wine — (логично) независимо от того, работает ли R в Windows через Linux Wine или нет
- package — (символ), установлен ли пакет или нет. В дополнение к проверке доступности наличие package= в имени файла дает понять, что файл запуска относится к настройкам, характерным для этого пакета.
С определенной периодичностью:
- when - (символ) укажите, как часто файл должен обрабатываться:
- when=once — файл запуска обрабатывается только один раз
- when=hourly – файл запуска обрабатывается не чаще одного раза в час.
- when=daily – файл запуска обрабатывается не чаще одного раза в день.
- when=weekly – файл запуска обрабатывается не чаще одного раза в неделю.
- when=fortnightly – файл запуска обрабатывается не чаще одного раза в две недели.
- when=monthly – файл запуска обрабатывается не чаще одного раза в месяц.
Если такой файл или его метка времени обновлены, он будет обработан при следующем запуске R.
- Любые дальнейшие = спецификации с ключами, не соответствующими ни одному из перечисленных выше ключей, интерпретируются как системные переменные среды, и запуск будет проверять такие условия на соответствие их значениям. Обратите внимание: если не соответствует известной переменной среды, то файл пропускается, если используется =, но включается, если используется !=.
Чтобы указать более одного ключа, разделите = пары запятыми, например. ~/.Rprofile.d/work,interactive=TRUE,os=windows.R . Это также работает для имен каталогов. Например, ~/.Rprofile.d/os=windows/work,interactive=TRUE.R будет обрабатываться при работе в Windows и в интерактивном режиме. Можно указать несколько пакетов. Например, ~/.Rprofile.d/package=devtools,package=future.R будет использоваться, только если установлены и devtools, и будущие пакеты.
Также можно отменить проверку условного имени файла, используя спецификацию !=. Например, ~/.Rprofile.d/package=doMC,os!=windows.R будет обработан, если пакет doMC установлен и операционная система не Windows.
Секреты (условно для переменной среды)
Загрузочные файлы Renviron и Rprofile, имена которых не указаны, пропускаются. Необъявленный ключ — это любой ключ, который не является ни одним из предопределенных ключей, указанных выше, ни объявленной переменной среды.
Это полезно, потому что позволяет нам хранить "секреты" в частных файлах и загружать их только в зависимости от значения переменной среды. Например, мы поместили все наши секретные файлы Renviron в папку ~/.Renviron.d/private/SECRET=banana/, чтобы они загружались только в том случае, если переменная окружения SECRET установлена точно в банан. Более того, убедившись, что каталог ~/.Renviron.d/private/ доступен только вам, тогда кому-то другому будет сложнее узнать ваш секретный «пароль» (banan). В системе Unix вы можете настроить это как:
Тогда поместите туда свои секретные файлы Renviron, например,
Теперь, только если для параметра SECRET установлено значение банана при запуске R, указанные выше секретные файлы будут обработаны, и соответствующие переменные среды будут доступны из R. Например, они будут загружены, если вы выполните следующее:
но не в том случае, если вы это сделаете:
или если SECRET не установлен.
Комментарий: Вы можете использовать любое имя переменной, которое вам нравится, оно не обязательно должно быть SECRET . И банан с паролем, очевидно, просто пример.
Известные ограничения
Настройка переменных среды во время запуска
- TMPDIR , TMP , TEMP — родитель временного каталога R, ср. ?tempdir
- LC_ALL — языковые настройки, используемые R, например ср. ?локали
- R_DEFAULT_PACKAGES — набор пакетов по умолчанию, загружаемых при запуске R, ср. ?R-скрипт
- R_LIBS_USER – путь к пользовательской библиотеке, например. R_LIBS_USER=~/R/%p-library/%v — это спецификация папки, используемая по умолчанию на всех платформах и в версии R. Папка должна существовать, иначе R ее игнорирует. Части %p (платформа) и %v (версия) являются специфическими для R спецификаторами преобразования, ср. ?R_LIBS_USER
- R_MAX_NUM_DLLS , ср. ?dyn.load
Любые изменения, сделанные в файле Renviron.d (шаг 3a) или с помощью Sys.setenv() в файлах .Rprofile (шаг 2) или Rprofile.d (шаг 3c), будет проигнорирован самим R, несмотря на то, что он будет отражен Sys.getenv() .
Файл настроек Django содержит всю конфигурацию вашей установки Django. В этом документе объясняется, как работают настройки и какие настройки доступны.
Основы¶
Файл настроек — это просто модуль Python с переменными уровня модуля.
Вот несколько примеров настроек:
Если для параметра DEBUG установлено значение False , вам также необходимо правильно установить параметр ALLOWED_HOSTS.
Поскольку файл настроек представляет собой модуль Python, применяются следующие правила:
Он не допускает синтаксических ошибок Python.
Он может динамически назначать настройки, используя обычный синтаксис Python. Например:
Он может импортировать значения из других файлов настроек.
Обозначение настроек¶
Когда вы используете Django, вы должны сообщить ему, какие настройки вы используете. Для этого используйте переменную среды DJANGO_SETTINGS_MODULE .
Значение DJANGO_SETTINGS_MODULE должно быть в синтаксисе пути Python, например. мой сайт.настройки . Обратите внимание, что модуль настроек должен находиться на пути поиска импорта Python.
Утилита django-admin¶
При использовании django-admin вы можете либо установить переменную среды один раз, либо явно передавать модуль настроек при каждом запуске утилиты.
Пример (оболочка Unix Bash):
Пример (оболочка Windows):
Используйте аргумент командной строки --settings, чтобы указать параметры вручную:
На сервере ( mod_wsgi )¶
В среде реального сервера вам необходимо указать приложению WSGI, какой файл настроек использовать. Сделайте это с помощью os.environ :
Прочитайте документацию Django mod_wsgi для получения дополнительной информации и других общих элементов приложения Django WSGI.
Настройки по умолчанию¶
Файл настроек Django не должен определять какие-либо настройки, если в этом нет необходимости. Каждый параметр имеет разумное значение по умолчанию. Эти значения по умолчанию находятся в модуле django/conf/global_settings.py.
Вот алгоритм, который Django использует при компиляции настроек:
- Загрузить настройки из global_settings.py .
- Загрузить настройки из указанного файла настроек, при необходимости переопределив глобальные настройки.
Обратите внимание, что файл настроек не должен импортироваться из global_settings , поскольку это избыточно.
Просмотр измененных настроек¶
Команда python manage.py diffsettings отображает различия между текущим файлом настроек и настройками Django по умолчанию.
Дополнительную информацию см. в документации по diffsettings.
Использование настроек в коде Python¶
В приложениях Django используйте настройки, импортировав объект django.conf.settings . Пример:
Обратите внимание, что django.conf.settings — это не модуль, а объект. Поэтому импорт отдельных настроек невозможен:
Также обратите внимание, что ваш код не должен импортировать ни из global_settings, ни из вашего собственного файла настроек. django.conf.settings абстрагирует концепции настроек по умолчанию и настроек, специфичных для сайта; он представляет единый интерфейс. Это также отделяет код, использующий настройки, от расположения ваших настроек.
Изменение настроек во время выполнения¶
Не следует изменять настройки приложений во время выполнения. Например, не делайте этого в представлении:
Единственное место, где вы должны назначать настройки, — это файл настроек.
Безопасность¶
Поскольку файл настроек содержит конфиденциальную информацию, такую как пароль базы данных, вы должны сделать все возможное, чтобы ограничить доступ к нему. Например, измените права доступа к файлу, чтобы его могли читать только вы и пользователь вашего веб-сервера. Это особенно важно в среде общего хостинга.
Доступные настройки¶
Полный список доступных настроек см. в справочнике по настройкам .
Создание собственных настроек¶
Ничто не мешает вам создавать собственные настройки для собственных приложений Django, но следуйте этим рекомендациям:
- Названия настроек должны быть все в верхнем регистре.
- Не изобретайте уже существующие настройки.
Для настроек, являющихся последовательностями, Django использует списки, но это всего лишь соглашение.
Использование настроек без установки DJANGO_SETTINGS_MODULE ¶
В некоторых случаях может потребоваться обойти переменную среды DJANGO_SETTINGS_MODULE. Например, если вы используете систему шаблонов отдельно, вы, вероятно, не захотите настраивать переменную среды, указывающую на модуль настроек.
В этих случаях вы можете настроить параметры Django вручную. Сделайте это, позвонив:
django.conf.settings. настроить (настройки по умолчанию, **настройки)¶
Передайте configure() столько аргументов ключевого слова, сколько хотите, причем каждый аргумент ключевого слова представляет параметр и его значение. Имя каждого аргумента должно быть написано прописными буквами, с тем же именем, что и настройки, описанные выше. Если какой-либо параметр не передается в configure() и потребуется позже, Django будет использовать значение параметра по умолчанию.
Настройка Django таким образом в основном необходима и даже рекомендуется, когда вы используете часть платформы внутри более крупного приложения.
Следовательно, при настройке с помощью settings.configure() Django не будет вносить никаких изменений в переменные среды процесса (см. документацию TIME_ZONE, почему это обычно происходит). Предполагается, что в таких случаях вы уже полностью контролируете свою среду.
Пользовательские настройки по умолчанию¶
Если вы хотите, чтобы значения по умолчанию брались не из django.conf.global_settings, а из другого источника, вы можете передать модуль или класс, предоставляющий параметры по умолчанию, в качестве аргумента default_settings (или в качестве первого позиционного аргумента) в вызове настроить() .
В этом примере настройки по умолчанию берутся из myapp_defaults , а для параметра DEBUG установлено значение True независимо от его значения в myapp_defaults :
Следующий пример, использующий myapp_defaults в качестве позиционного аргумента, эквивалентен:
Обычно вам не нужно переопределять значения по умолчанию таким образом. Значения Django по умолчанию достаточно просты, чтобы вы могли безопасно их использовать. Имейте в виду, что если вы передаете новый модуль по умолчанию, он полностью заменяет значения по умолчанию Django, поэтому вы должны указать значение для каждого возможного параметра, который может использоваться в импортируемом коде. Полный список можно найти на django.conf.settings.global_settings.
Требуется либо configure(), либо DJANGO_SETTINGS_MODULE¶
Если вы не устанавливаете переменную среды DJANGO_SETTINGS_MODULE, вы должны вызвать configure() в какой-то момент, прежде чем использовать какой-либо код, считывающий настройки.
Если вы не установите DJANGO_SETTINGS_MODULE и не вызовете configure() , Django вызовет исключение ImportError при первом доступе к параметру.
Если вы установите DJANGO_SETTINGS_MODULE , каким-то образом получите доступ к значениям настроек, затем вызовите configure() , Django выдаст ошибку RuntimeError, указывающую, что настройки уже настроены. Для этого есть свойство:
Кроме того, вызов configure() более одного раза или вызов configure() после обращения к любому параметру является ошибкой.
Это сводится к следующему: используйте только один из configure() или DJANGO_SETTINGS_MODULE . Не то и другое, и не ни то, ни другое.
Вызов django.setup() требуется для «автономного» использования Django¶
Если вы используете компоненты Django «отдельно» — например, пишете скрипт Python, который загружает некоторые шаблоны Django и отображает их, или использует ORM для получения некоторых данных — вам потребуется еще один шаг. к настройке параметров.
После того, как вы установили DJANGO_SETTINGS_MODULE или вызвали configure() , вам нужно будет вызвать django.setup(), чтобы загрузить настройки и заполнить реестр приложений Django. Например:
Обратите внимание, что вызов django.setup() необходим только в том случае, если ваш код действительно автономен. При вызове вашим веб-сервером или через django-admin Django сделает это за вас.
django.setup() может вызываться только один раз.
Поэтому избегайте размещения многократно используемой логики приложения в автономных скриптах, чтобы вам пришлось импортировать из скрипта в другое место вашего приложения. Если вы не можете этого избежать, поместите вызов django.setup() в блок if:
Справочник по параметрам Содержит полный список основных и вспомогательных параметров приложения.
Читайте также: