/oscript-yacloud

Реализация CLI Яндекс.Облака для OneScript

Primary Language1C EnterpriseMIT LicenseMIT

Реализация CLI Яндекс.Облака для OneScript

Информация

Библиотека предоставляет возможность взаимодействия с CLI Яндекс.Облака на языке OneScript.

Установка

CLI Яндекс.Облака

  1. Установка CLI Яндекс.Облака
  2. Создание профиля CLI Яндекс.Облака и первоначальные настройки

OneScript

Для работы библиотеки oscript-yacloud необходимо предварительно установить Стандартную библиотеку скриптов OneScript.

opm install yacloud

Использование

Cloud

  1. Общие методы работы с облаком расположены в модуле ОблакоYC

  2. Для работы CLI Яндекс.Облака требуется авторизоваться с использованием методов:

    СтрокаOAuthToken = ПодключениеYC.ПрочитатьOAuthTken("OAuthToken");
    ПодключениеYC.ВыполнитьПодключение(СтрокаOAuthToken);
    
    • OAuthToken - текстовый файл с токеном
    • СтрокаOAuthToken - строковое представление токена

Compute Cloud

  1. Подготовка к созданию виртуальной машины

    1.1 Создать файл авторизации

    1.2 Создать конфигурационный файл

    • КлючАвторизации
      • ПутьКФайлу - путь к ранее соозданному файлу для авторизации к ВМ;
    • ЗонаДоступности - зона в которой расположена виртуальная сеть. Все существующие виртуальные сети можно получить с помощью метода:
      ОблакоYC.ПолучитьСписокПодсетей();
      
    • ОбъемОперативнойПамятиГБ - объем оперативной памяти;
    • КоличествоЯдер - количество виртуальных ядер;
    • ГарантированнаяДоляПроцессора - гарантированная доля процессора в процентах. (5, 20, 50, 100);
    • Прерываемая - признак определяет будет ли ВМ прерываемой;
    • ЗагрузочныйДиск
      • ИмяДиска - имя диска;
      • ТипДиска - "network-hdd" или "network-ssd";
      • ОбъемГб - объем в ГБ;
      • ИмяСтандартногоОбраза - имя образа который будет развенут. Все имеющиеся образы можно получить с помощью метода:
      ОблакоYC.ПолучитьСписокПубличныхОбразов();
      
    • ВиртуальнаяСеть
      • ИмяСети - имя ранее созданной виртуальной сети;
      • IPv4Адрес - IP адрес в виртуальной сети;
      • ИспользоватьДинамическийIP - признак использования ранее созданного динамического IP адреса;
      • ПубличныйСтатическийIP - предопределенный публичный IP адрес. Данный параметр приоритетнее параметра ИспользоватьДинамическийIP.
  2. Пример полного цикла жизни виртуальной машины:

    #Использовать yacloud
    
    // Выполняю подключение
    СтрокаOAuthToken = ПодключениеYC.ПрочитатьOAuthTken("OAuthToken");
    ПодключениеYC.ВыполнитьПодключение(СтрокаOAuthToken);
    
    // Создаю новую виртуальную машину
    ВиртуальнаяМашинаYC = Новый ВиртуальнаяМашинаYC("docker-01");
    ВиртуальнаяМашинаYC.Создать("./cloud/сomputeсloud/linux.xml");
    
    // Получаю свойства ранее созданной виртуальной машины
    ВиртуальнаяМашинаYC.Свойства();
    Сообщить(ВиртуальнаяМашинаYC.IPАдресВнешний());
    
    // Выполняю действия над машиной
    ОблакоYC.ПолучитьСписокВиртуальныхМашин();
    ВиртуальнаяМашинаYC.Остановить();
    ВиртуальнаяМашинаYC.Запустить();
    ВиртуальнаяМашинаYC.Перезапустить();
    ВиртуальнаяМашинаYC.Удалить();
    

License

MIT. Использование сервиса Платформы Яндекс.Облако регламентируется Условиями использования сервиса "Платформа Яндекс.Облако" (https://cloud.yandex.ru/docs/cli/).