нож супермаркет

[edit on GitHub]

Подкоманда knife supermarket используется для взаимодействия с кулинарными книгами, расположенными в публичном супермаркете, а также в частных сайтах супермаркета Chef. Для любых действий с сообществом, записывающих данные в супермаркет Chef, требуется учетная запись пользователя; однако следующие аргументы не требуют учетной записи пользователя: download, search, install, и list.

скачать

Используйте аргумент download для скачивания кулинарной книги из супермаркета Chef. Кулинарная книга будет загружена как архив tar.gz и помещена в текущую рабочую директорию. Если кулинарная книга (или версия кулинарной книги) устарела, и опция --force не используется, knife предупредит пользователя о том, что кулинарная книга устарела, и предоставит имя самой последней не устаревшей версии этой кулинарной книги.

Синтаксис

У этого аргумента следующий синтаксис:

knife supermarket download COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Параметры

У этого аргумента следующие параметры:

COOKBOOK_VERSION

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

-f FILE, --file FILE

Файл, в который будет записана загруженная кулинарная книга.

--force

Перезаписать существующую директорию.

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Скачать кулинарную книгу

Чтобы скачать кулинарную книгу mysql, введите:

knife supermarket download mysql

установить

Используйте аргумент install для установки кулинарной книги, загруженной из супермаркета Chef, в локальный репозиторий git. Это действие использует систему управления версиями git в сочетании с сайтом супермаркета Chef для установки кулинарных книг, созданных сообществом, в локальный репозиторий chef-repo. Этот аргумент выполняет следующие действия:

1. Создается новая ветка "pristine copy" в git для отслеживания исходного кода.
2. Все существующие версии кулинарной книги удаляются из ветки.
3. Кулинарная книга загружается из супермаркета Chef в формате tar.gz.
4. Загруженная кулинарная книга распаковывается, ее содержимое коммитится в git и создается тэг.
5. Ветка "pristine copy" сливается с веткой master.

Этот процесс позволяет изменять кулинарную книгу в ветке master, позволяя git сохранять изменения как отдельный патч. Когда появится обновлённая версия исходного кода, эти изменения могут быть объединены, сохраняя при этом все локальные модификации.

Синтаксис

У этого аргумента следующий синтаксис:

knife supermarket install COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Параметры

У этого аргумента следующие параметры:

-b, --use-current-branch

Убедиться, что используется текущая ветка.

-B BRANCH, --branch BRANCH

Имя ветки по умолчанию. По умолчанию используется ветка master.

COOKBOOK_VERSION

Версия кулинарной книги для установки. Если версия не указана, устанавливается последняя версия кулинарной книги.

-D, --skip-dependencies

Убедиться, что все кулинарные книги, от которых установленная кулинарная книга зависит, не установлены.

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

-o PATH:PATH, --cookbook-path PATH:PATH

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

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Установить кулинарную книгу

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

knife supermarket install mysql

список

Используйте аргумент list для просмотра списка кулинарных книг, которые в настоящее время доступны в супермаркете Chef.

Синтаксис

У этого аргумента следующий синтаксис:

knife supermarket list (options)

Параметры

У этого аргумента следующие параметры:

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

-w, --with-uri

Показать соответствующие URI.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Просмотр списка кулинарных книг

Чтобы просмотреть список кулинарных книг на сервере Chef Supermarket, введите:

knife supermarket list

чтобы получить список, похожий на:

1password                            minecraft
301                                  mineos
7-zip                                minidlna
AWS_see_spots_run                    minitest
AmazonEC2Tag                         minitest-handler
Appfirst-Cookbook                    mirage
CVE-2014-3566-poodle                 mlocate
CVE-2015-0235                        mod_security
Obfsproxy                            mod_security2
R                                    modcloth-hubot
Rstats                               modcloth-nad
SysinternalsBginfo                   modman
VRTSralus                            modules
abiquo                               mogilefs
acadock                              mongodb
accel-ppp                            mongodb-10gen
accounts                             mongodb-agents
accumulator                          monit
...

поиск

Используйте аргумент search для поиска кулинарных книг в супермаркете Chef. Запрос поиска используется для возврата списка этих кулинарных книг и использует тот же синтаксис, что и подкоманда knife search.

Синтаксис

У этого аргумента следующий синтаксис:

knife supermarket search SEARCH_QUERY (options)

Параметры

У этого аргумента следующие параметры:

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Поиск кулинарных книг

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

knife supermarket search mysql

где mysql — поисковый запрос. Это вернёт что-то подобное:

mysql:
  cookbook:             https://supermarket.chef.io/api/v1/cookbooks/mysql
  cookbook_description: Provides mysql_service, mysql_config, and mysql_client resources
  cookbook_maintainer:  chef
  cookbook_name:        mysql
mysql-apt-config:
  cookbook:             https://supermarket.chef.io/api/v1/cookbooks/mysql-apt-config
  cookbook_description: Installs/Configures mysql-apt-config
  cookbook_maintainer:  tata
  cookbook_name:        mysql-apt-config
mysql-multi:
  cookbook:             https://supermarket.chef.io/api/v1/cookbooks/mysql-multi
  cookbook_description: MySQL replication wrapper cookbook
  cookbook_maintainer:  rackops
  cookbook_name:        mysql-multi

разместить

Используйте аргумент share для добавления кулинарной книги в супермаркет Chef. Для этого действия потребуется учетная запись пользователя и сертификат для супермаркета Chef. По умолчанию knife будет использовать имя пользователя и ключ API, указанные в конфигурационном файле, используемом во время загрузки; в противном случае эти значения должны быть указаны в командной строке или в альтернативном конфигурационном файле. Если кулинарная книга уже существует в супермаркете Chef, то только владелец или ответственный за эту кулинарную книгу может внести изменения.

Синтаксис

У этого аргумента следующий синтаксис:

knife supermarket share COOKBOOK_NAME CATEGORY (options)

Параметры

У этого аргумента следующие параметры:

CATEGORY

Категория кулинарной книги: "Databases", "Web Servers", "Process Management", "Monitoring & Trending", "Programming Languages", "Package Management", "Applications", "Networking", "Operating Systems & Virtualization", "Utilities", или "Other".

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

-o PATH:PATH, --cookbook-path PATH:PATH

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

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Разместить кулинарную книгу

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

knife supermarket share "my_apache2_cookbook" "Web Servers"

показать

Используйте аргумент show для просмотра информации о кулинарной книге, расположенной в супермаркете Chef.

Синтаксис

У этого аргумента следующий синтаксис:

knife supermarket show COOKBOOK_NAME [COOKBOOK_VERSION] (options)

Параметры

У этого аргумента следующие параметры:

COOKBOOK_VERSION

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

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Показать данные о кулинарной книге

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

knife supermarket show mysql

чтобы получить что-то подобное:

average_rating:
category:        Other
created_at:      2009-10-28T19:16:54.000Z
deprecated:      false
description:     Provides mysql_service, mysql_config, and mysql_client resources
external_url:    https://github.com/chef-cookbooks/mysql
issues_url:      https://github.com/chef-cookbooks/mysql/issues
latest_version:  https://supermarket.chef.io/api/v1/cookbooks/mysql/versions/8.5.1
maintainer:      sous-chefs
metrics:
  collaborators: 2
  downloads:
    total:    128998032
  versions:
    0.10.0: 927561
    0.15.0: 927536
    0.20.0: 927321
    0.21.0: 927298
    0.21.1: 927311
    0.21.2: 927424
    0.21.3: 927441
    0.21.5: 927326
    0.22.0: 927297
    0.23.0: 927353
    0.23.1: 927862
    0.24.0: 927316

Показать данные о версии кулинарной книги

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

knife supermarket show mysql 8.5.1

где mysql — кулинарная книга, а 8.5.1 — версия кулинарной книги. Это вернёт что-то подобное:

average_rating:
cookbook:          https://supermarket.chef.io/api/v1/cookbooks/mysql
file:              https://supermarket.chef.io/api/v1/cookbooks/mysql/versions/8.5.1/download
license:           Apache-2.0
published_at:      2017-08-23T19:01:28Z
quality_metrics:
  failed:   false
  feedback: passed the No Binaries metric. Contains no obvious binaries.
  name:     No Binaries

  failed:   false
  feedback: mysql passed the publish metric
  name:     Publish

  failed:   false
  feedback: mysql supports at least one platform.
  name:     Supported Platforms

  failed:   false
  feedback: passed the Collaborators Metric with 2 collaborators.
  name:     Collaborator Number

  failed:   false
  feedback:
  Run with Foodcritic Version 14.0.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
  name:     Foodcritic

  failed:   false
  feedback: passed the CONTRIBUTING.md file metric.
  name:     Contributing File

  failed:   false
  feedback: passed the version tag metric.
  name:     Version Tag

  failed:   false
  feedback: passed the TESTING.md file metric.
  name:     Testing File
supports:
  amazon:       >= 0.0.0
  centos:       >= 6.0
  debian:       >= 7.0
  fedora:       >= 0.0.0
  opensuseleap: >= 0.0.0
  oracle:       >= 6.0
  redhat:       >= 6.0
  scientific:   >= 6.0
  suse:         >= 12.0
  ubuntu:       >= 12.04
tarball_file_size: 23763
version:           8.5.1

удалить_из_размещения

Используйте аргумент unshare для прекращения размещения кулинарной книги, расположенной в супермаркете Chef. Только ответственный за кулинарную книгу может выполнить это действие.

Синтаксис

У этого аргумента следующий синтаксис:

knife supermarket unshare COOKBOOK_NAME/versions/VERSION (options)

Параметры

У этого аргумента следующие параметры:

-m, --supermarket-site

URL расположения супермаркета Chef. Значение по умолчанию: https://supermarket.chef.io.

Примеры

В следующих примерах показано, как использовать эту подкоманду knife:

Удалить кулинарную книгу из размещения

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

knife supermarket unshare "my_apache2_cookbook" "Web Servers"

Удалить доступ к версии кулинарной книги

Чтобы удалить доступ к версии кулинарной книги 0.10.0 для кулинарной книги my_apache2_cookbook, введите:

knife supermarket unshare "my_apache2_cookbook/versions/0.10.0"