sitecopy - Интернет в облаке

ПРОГРАММА:

ИМЯ

sitecopy - поддерживать удаленные копии веб-сайтов

СИНТАКСИС

копия сайта [опции] [операция Режим] имя_сайта ...

ОПИСАНИЕ

копия сайта предназначен для копирования локально сохраненных веб-сайтов на удаленные веб-серверы. Единая команда
загрузит на сервер файлы, которые были изменены локально, и удалит файлы из
сервер, который был удален локально, чтобы удаленный сайт синхронизировался с
локальный сайт. Цель состоит в том, чтобы избавиться от хлопот с загрузкой и удалением отдельных файлов.
с помощью FTP-клиента. sitecopy также при желании попытается обнаружить файлы, которые вы перемещаете локально,
и перемещать их удаленно.

FTP, SFTP, WebDAV и другие серверы разработки на основе HTTP (например, AOLserver и
Netscape Enterprise) поддерживаются.

ПОЛУЧЕНИЕ НАЧАЛ

В этом разделе рассказывается, как начать поддерживать веб-сайт с помощью sitecopy. После введения
основы, рассматриваются две ситуации: во-первых, когда вы уже загрузили сайт в
удаленный сервер; во-вторых, где вы этого не сделали. Наконец, обычная работа по обслуживанию сайта
объяснены.

Вводя Основная информация
Если вы еще этого не сделали, вам нужно создать rcfile, в котором будут храниться
информация о сайтах, которыми вы хотите управлять. Также нужно создать хранилище
каталог, который sitecopy использует для записи состояния файлов на каждом из удаленных
места. Каталог rcfile и хранилище должны быть доступны только вам - sitecopy
иначе не запустится. Чтобы создать каталог хранилища с правильными разрешениями, используйте
команда
MkDir -m 700 .сайткопия
из вашего домашнего каталога. Чтобы создать rcfile, используйте команды
трогать .sitecopyrc
CHMOD 600 .sitecopyrc
из вашего домашнего каталога. Как только это будет сделано, отредактируйте rcfile, чтобы ввести данные вашего сайта как
показано в разделе КОНФИГУРАЦИЯ.

Существующий Удаленный Сайт
Если вы уже загрузили сайт на удаленный сервер, убедитесь, что ваши локальные файлы
синхронизируется с удаленными файлами. Затем запустите
копия сайта --настигнуть имя_сайта
где sitename - это название используемого вами сайта после сайте ключевое слово в файле rcfile.

Если у вас нет локальной копии удаленного сайта, вы можете использовать получать Режим в
узнать, что находится на удаленном сайте, и синхронизировать Режим чтобы скачать это. Режим извлечения работает
хорошо подходит для серверов WebDAV и может работать, если вам повезет для серверов FTP. Бегать
копия сайта --принести имя_сайта
для получения сайта - если это удастся, запустите
копия сайта --синхронизировать имя_сайта
скачать локальную копию. НЕ делайте этого, если у вас уже есть локальная копия вашего сайта.

Новое Удаленный Сайт
Убедитесь, что корневой каталог сайта был создан на сервере сервером.
администратор. Бегать
копия сайта --в этом имя_сайта
где sitename - это название используемого вами сайта после сайте ключевое слово в файле rcfile.

Сайт Обслуживание
После настройки сайта, как указано в одном из двух вышеупомянутых разделов, теперь вы можете начать
редактирование ваших локальных файлов как обычно. Когда вы закончили набор изменений, и вы хотите
чтобы обновить удаленную копию сайта, запустите:
копия сайта --Обновить имя_сайта
и все измененные файлы будут загружены на сервер. Любые файлы, которые вы удаляете локально
будут удалены также удаленно, если только ноделет опция указывается в файле rcfile. Если
вы перемещаете любые файлы между каталогами, удаленные файлы будут удалены с сервера
затем загружается снова, если вы не укажете проверить вариант в rcfile.

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

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

ПРИЗЫВ

В нормальном режиме работы укажите одинарной режим работы, за которым следуют любые выбранные вами параметры,
затем одно или несколько названий сайтов. Например,
копия сайта --Обновить --тихий главный сайт другой сайт
незаметно обновит сайты с именами mainsite и anothersite.

РАБОТА РЕЖИМЫ

-л, --список
Список режим - выводит список всех различий между локальными файлами и
удаленная копия для указанных сайтов.

-ll, -- Flatlist
Плоский (XNUMXD) список режим - как режим списка, за исключением того, что вывод подходит для синтаксического анализа
внешним скриптом или программой. Сценарий AWK, изменения.awk. предоставляется, который
создает HTML-страницу из этого режима.

-у, --обновить
Обновление ПО режим - обновляет удаленную копию указанных сайтов.

-f, --fetch
получать режим - получает список файлов с удаленного сервера. Обратите внимание, что этот режим
имеет только ограниченную поддержку в FTP - сервер должен принимать МДТМ команда и используйте
"ls" в стиле Unix для реализации LIST.

-s, --синхронизировать
синхронизировать режим - обновляет локальным сайт из удаленной копии. ПРЕДУПРЕЖДЕНИЕ: Этот режим
перезаписывает локальные файлы. Используйте с осторожностью.

-я, --инициализировать
Инициализация режим - инициализирует указанные сайты - заставляя sitecopy думать там
НЕТ файлов на удаленном сервере.

-с, --догнать
Наверстать режим - заставляет sitecopy думать, что локальный сайт точно такой же, как и
удаленная копия.

-в, --вид
Просмотр режим - отображает все определения сайтов из файла rcfile.

-е, --проверить
Убедитесь, что сохраненное состояние сайта соответствует реальному удаленному состоянию

-х, --помощь
Показать справочную информацию.

-V, --версия
Показать информацию о версии.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

-у, - подсказка

-g, --logfile = ФАЙЛ
Добавить отладочные сообщения в ФАЙЛ (иначе используйте stderr)

-x, --create-удаленный
Создать рут для удаленного сайта

-n, -- пробный запуск
Отображение, но не выполнение операции Применимо в Обновление ПО режим только будет
запрашивать у пользователя подтверждение для каждого обновления (т. е. создание каталога,
загрузка файла и т. д.).

-r RCFILE, --rcfile = RCFILE
Укажите альтернативное расположение файла управления запуском.

-p ПУТЬ, --storepath = ПУТЬ
Укажите альтернативное расположение для каталога хранилища удаленного сайта.

-к, --тишина
Тихий вывод - отображать имя файла только для каждого выполненного обновления.

-qq, --молчаливый
Очень тихий вывод - ничего не отображается для каждого выполненного обновления.

-o, --show-прогресс
Применимо в Обновление ПО режим только, отображает прогресс (процент завершения) данных
перевод.

-k, --продолжать
Продолжайте проходить ошибки в Обновление ПО режим or синхронизировать режим

-а, --все сайты
Выполнить данную операцию на всех сайтах - применимо для всех режимов, кроме Просмотр
Режим, для которых это не имеет никакого эффекта.

-d МАСКА, --debug = КЛЮЧ [, КЛЮЧ ...]
Включает отладку. Должен быть указан список ключевых слов, разделенных запятыми. Каждый
ключевое слово может быть одним из:
сокет Обработка сокетов
файлы Обработка файлов
rcfile анализатор rcfile
HTTP драйвер HTTP
httpbody Отображение тела ответа в HTTP
ftp драйвер FTP
sftp драйвер SFTP
xml Информация о синтаксическом анализе XML
xmlparse Информация о низкоуровневом синтаксическом анализе XML
httpauth информация об аутентификации HTTP
открытый текст Отображение паролей в виде обычного текста

Пароли будут скрыты в выводе отладки, если не указано ключевое слово cleartext.
использовал. Пример использования отладки - отладка режима выборки FTP:

копия сайта --debug = ftp, сокет --принести имя_сайта

КОНЦЕПЦИИ

Команда хранить состояние сайта - это снимок состояния сайта, сохраненный в хранилище
каталог (~ / .sitecopy /). диск файл используется для записи этого состояния между
призывы. В режиме обновления sitecopy создает файлов список для каждого сайта путем сканирования
локальный каталог, чтение в сохраненном состоянии и сравнение двух - определение того, какой
файлы изменились, которые переместились и т. д.

КОНФИГУРАЦИЯ

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

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

Сайт Определение
Определение сайта состоит из ряда строк:

сайте имя_сайта
сервер имя сервера
удаленные  удаленный корневой каталог
локальным локальный корневой каталог
[ порт номер порта ]
[ username имя пользователя ]
[ password пароль ]
[ Прокси сервер прокси-имя
порт прокси номер порта ]
[ URL адрес сайта ]
[ протокол {ftp | sftp | webdav}]
[ FTP nopasv]
[ FTP showquit]
[ FTP {usecwd | nousecwd}]
[ HTTP ожидать ]
[ HTTP безопасный ]
[ безопасный ]
[ состояние {контрольная сумма | timesize}]
[ Разрешения {игнорировать | exec | все | dir}]
[ символические ссылки {игнорировать | следовать | поддерживать } ]
[ ноделет ]
[ не перезаписывать ]
[ проверить [переименовывает]]
[ временная загрузка ]
[ исключать шаблон ]...
[ игнорировать шаблон ]...
[ ASCII шаблон ]...

Все, что стоит после решетки (#) в строке, игнорируется как комментарий. Значения могут быть указаны и
символы могут быть экранированы обратной косой чертой. Например, чтобы использовать исключать шаблон * #, используйте
следующая строка:
исключать "* #"

Удаленный серверу Опции
Команда сервер ключ используется для указания удаленного сервера, на котором хранится сайт. Это может быть
либо DNS-имя, либо IP-адрес. Подключение выполняется к порту по умолчанию для протокола.
использованный, или предоставленный порт ключ. sitecopy поддерживает протоколы WebDAV или (S) FTP -
протокол key указывает, что использовать, принимая значение либо вебдав or ftp / sftp
соответственно. По умолчанию будет использоваться FTP.

Команда Прокси сервер и порт прокси ключи могут использоваться для указания используемого прокси-сервера. Прокси
серверы в настоящее время поддерживаются только для WebDAV.

Если FTP-сервер не поддерживает пассивный (PASV) режим, то ключ FTP нопасв должно быть
использовал. Чтобы отобразить сообщение, возвращаемое сервером при закрытии соединения, используйте
FTP шоу вариант. Если сервер поддерживает загрузку файлов только в текущем рабочем
каталог, используйте ключ FTP использовать (возможный симптом: «отказано в разрешении на перезапись»). Примечание
что удаленный каталог (ключевое слово удаленные ) должен быть абсолютным путем (начиная с '/'),
or использовать будут проигнорированы.

Если сервер WebDAV правильно поддерживает ожидание продолжения 100, например Apache 1.3.9
а позже ключ HTTP ожидать должен быть использован. Это поможет сэкономить трафик и время.
в обновлении.

Если сервер WebDAV поддерживает доступ через SSL, ключ HTTP безопасный может быть использован. Делать это
приведет к тому, что передачи между копией сайта и хостом будут выполняться с использованием безопасного,
зашифрованная ссылка. При первом использовании SSL для доступа к серверу пользователь будет
предлагается проверить сертификат SSL, если он не подписан центром сертификации, которому доверяют в системе
Корневой комплект CA.

Для аутентификации пользователя на сервере username и password ключи используются. Если это
существует, ~ / .netrc будет выполняться поиск пароля, если он не указан. Видеть FTP(1)
для синтаксиса этого файла.

Для WebDAV поддерживаются простая и дайджест-аутентификация. Обратите внимание, что базовая аутентификация
не должны использоваться, если не известно, что соединение является безопасным.

Полный URL-адрес, который используется для доступа к сайту, может быть дополнительно указан в поле URL .
Используется только в режиме плоского списка, поэтому URL-адрес сайта можно вставить в «Последние изменения».
страниц. URL-адрес должен иметь в конце косую черту; действительный пример
URL http://www.site.com/mysite

Если же линия индикатора временная загрузка задана опция, новые или измененные файлы загружаются с расширением ".in." префикс,
затем перешел к истинному имени файла по завершении загрузки.

Файл Область
Состояние файла хранится в файлах хранилища (~ / .sitecopy /*), и используется, чтобы обнаружить, когда
файл был изменен. Поддерживаются два метода, которые можно выбрать с помощью состояние
вариант с любым параметром: размер (по умолчанию) и контрольная сумма.

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

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

Безопасно режим
Безопасно режим включается с помощью безопасный ключ. Если этот параметр включен, каждый раз, когда файл загружается в
сервер, время модификации файла as on сервер записывается. Впоследствии
всякий раз, когда этот файл был изменен локально и должен быть загружен снова, текущий
извлекается время модификации файла на сервере и сравнивается с сохраненным
ценность. Если они отличаются, то удаленная копия файла была изменена чужим
вечеринка. Появится предупреждающее сообщение, и ваша локальная копия файла не будет загружена.
поверх него, чтобы не потерять любые изменения.

Безопасный режим можно использовать с серверами FTP или WebDAV, но если используется Apache / mod_dav, mod_dav
0.9.11 или более поздней версии.

Внимание Безопасный режим нельзя использовать вместе с не перезаписывать вариант (см. ниже).

Файл Хранилище Локации
Команда удаленные  key указывает корневой каталог удаленной копии сайта. Это может быть в
форма абсолютного пути, например
удаленные  / www / mysite /
Для FTP каталог также может быть указан относительно каталога входа в систему, в котором
в случае, если перед ним должен стоять префикс "~ /", например:
удаленные  ~ / public_html /

Команда локальным key указывает каталог, в котором сайт хранится локально. Это может быть
задано относительно вашего домашнего каталога (как задано переменной окружения $ HOME), снова
используя префикс "~ /".
локальным ~ / html / foosite /
локальным / главная / фред / html / foosite /
эквивалентны, если для $ HOME установлено значение "/ home / fred".

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

Файл Разрешения... Управляемость
Обработка прав доступа к файлам диктуется Разрешения ключ, которому может быть дан один из
три значения:

игнорировать полностью игнорировать права доступа к файлам (по умолчанию),

Exec для отражения разрешений только исполняемых файлов,

ВСЕ чтобы отразить разрешения всех файлов.

Это можно использовать, например, для проверки прав доступа к файлам CGI. Опция
в настоящее время игнорируется для серверов WebDAV. Для FTP-серверов CHMOD выполняется удаленно
установить разрешения.

Для обработки разрешений каталога ключ:
Разрешения директория
может использоваться в дополнение к Разрешения ключ либо исполнитель, локальным or все. Обратите внимание, что
Разрешения ВСЕ не подразумевает Разрешения д.

Символический Ссылка Управляемость
Символьные ссылки, обнаруженные на локальном сайте, можно игнорировать, отслеживать или поддерживать. В
В режиме «следовать» ссылки на файлы по символическим ссылкам будут загружены вместо них. В
в режиме обслуживания, ссылка также будет создана удаленно, подробнее см. ниже.
Информация. Режим, используемый для каждого сайта, указывается с помощью символические ссылки ключ rcfile, который
может принимать значение игнорировать, следовать or поддерживать для выбора нужного режима.

Режим по умолчанию следовать, т.е. переходят по символическим ссылкам, найденным на локальном сайте.

Символический ссылке. Поддерживать режим
Этот режим в настоящее время поддерживается только драйвером WebDAV и будет работать только с
серверы, которые реализуют расширенные коллекции WebDAV, работа над которыми еще не завершена. В
цель ссылки на сервере буквально копируется из цели символической ссылки. Намекать:
вы можете использовать URL-адреса, если хотите:
ln -s "http://www.somewhere.org/" где-нибудь

Таким образом, «302 редирект» может быть легко настроен из клиента, без необходимости
изменить конфигурацию сервера.

Удаление и Перемещение Удаленный Файлы
Команда ноделет Опция может использоваться для предотвращения удаления удаленных файлов. Это может
будет полезно, если вы храните большие объемы данных на удаленном сервере, которые вам не нужны.
хранить и на месте.

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

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

Если же линия индикатора проверить переименовывает используется опция, sitecopy будет искать все файлы, которые были
перемещен или переименован локально. Эта опция может использоваться только вместе с состояние
контрольная сумма опцию.

ПРЕДУПРЕЖДЕНИЕ

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

Без учета Файлы
Файлы могут быть исключены из списка файлов с помощью исключать ключ, который принимает оболочку-
стили подстановки шаблонов. Например, используйте
исключать * .bak
исключать *~
исключать "# * #"
чтобы исключить все файлы с расширением .bak, заканчивающиеся символом тильды (~) или
начинаются и заканчиваются хешем. Не забудьте заключить в кавычки или экранировать значение, если оно включает
хэш!

Чтобы исключить определенные файлы в определенном каталоге, просто добавьте к шаблону префикс
имя каталога, включая ведущую косую черту. Например:
исключать /документы/*.m4
исключать /файлы/*.gz
что исключит все файлы с расширением .m4 в подкаталоге 'docs' каталога
site и все файлы с расширением .gz в подкаталоге files.

Также можно исключить весь каталог - просто используйте имя каталога без завершающего
слэш. Например
исключать / foo / bar
исключать /где еще
чтобы исключить подкаталоги 'foo / bar' и 'where / else' сайта.

Шаблоны исключения используются при сканировании локального каталога и при сканировании
удаленный сайт во время --fetch. Любой файл, соответствующий любому шаблону исключения, не добавляется в
список файлов. Это означает, что файл, который уже был загружен с помощью sitecopy, и
впоследствии совпадение с шаблоном исключения будет удалено с сервера.

Игнорирование Местное изменения в Файлы
Команда игнорировать Параметр используется для указания копии сайта игнорировать любые локальные изменения, внесенные в файл.
Если в содержимое игнорируемого файла внесены изменения, этот файл будет быть загруженным
режим обновления. Игнорируемые файлы будут создаваться, перемещаться и удаляться как обычно.

Команда игнорировать опция используется так же, как исключать опцию.

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

Ftp Трансфер режим
Чтобы указать режим передачи файлов по FTP, используйте ASCII ключ. Любые файлы, которые
переданные с использованием режима ASCII имеют правильную трансляцию CRLF / LF. За
например, используйте
ASCII * .pl
для загрузки всех файлов с расширением .pl в виде текста ASCII. Этот ключ не работает с
WebDAV (в настоящее время).

ВЕРНУТЬ ЦЕННОСТИ:

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

Обновление ПО режим
-1 ... обновление даже не началось - проблема с настройкой
0 ... обновление прошло полностью успешно.
1 ... обновление где-то пошло не так
2 ... не удалось подключиться или войти на сервер

Список режим (дефолт Режим of операция)
-1 ... не удалось сформировать список - проблема с настройкой
0 ... удаленный сайт не требует обновления
1 ... удаленный сайт нуждается в обновлении

ПРИМЕР RCФАЙЛ СОДЕРЖАНИЕ

Ftp Сервер просто Применение
Сайт Фреда загружается на FTP-сервер my.server.com и хранится в каталоге
public_html, который находится в каталоге входа в систему. Сайт хранится локально в
каталог / home / fred / html.

сайт mysite
сервер my.server.com
URL http://www.server.com/fred
имя пользователя fred
пароль можжевельник
местный / домашний / фред / html /
удаленные  ~ / public_html /

Ftp Сервер Комплекс Применение
Здесь сайт Фреды загружен на FTP-сервер ´ftp.elsewhere.com´, где он хранится в
каталог / www / freda /. Локальный сайт хранится в / home / freda / sites / elsewhere /

сайт другой сайт
сервер ftp.elsewhere.com
имя пользователя freda
пароль бла-бла-бла
местный / дом / фреда / сайты / в другом месте /
удаленный / www / freda /
# Фреде нужны файлы с расширением .bak или
# завершающий ~ игнорировать:
исключить * .bak
исключить * ~

WebDAV Сервер просто Применение
В этом примере показано использование сервера WebDAV.

суперсайт
сервер dav.wow.com
протокол webdav
имя пользователя pow
пароль zap
местный / домашний / джо / www / super /
дистанционный пульт /

Используйте sitecopy онлайн с помощью сервисов onworks.net