Digital Ocean API를 사용하여 클라우드 인스턴스 관리

디지털오션이란?

Digital Ocean은 빠른 SSD 기반 서버와 월 5달러의 저렴한 호스팅 계획 덕분에 가장 빠르게 성장하는 웹 호스트 중 하나입니다. 테스트 또는 장기간 사용을 위해 Digital Ocean에서 인스턴스를 시작하는 것은 빠르고 쉬우며 저렴합니다.

Digital Ocean에서 재판매용 애플리케이션 이미지 구축에서는 WordPress(또는 기타 애플리케이션) 인스턴스를 스핀업하고 클라이언트를 위해 반복적으로 복제하는 방법을 보여줍니다. 이 튜토리얼에서는 Digital Ocean API를 사용하여 인스턴스(드롭이라고도 함)를 프로그래밍 방식으로 관리하고 일반적인 작업을 자동화하는 방법을 안내합니다. 또한 Yii Framework for PHP로 작성된 매우 기본적인 API 작업을 실행하기 위한 샘플 코드 베이스도 제공할 예정입니다. Github에서 코드를 얻을 수 있습니다.

디지털 오션 API

Digital Ocean API를 사용하면 HTTP 요청을 사용하여 간단하고 프로그래밍 방식으로 드롭릿과 리소스를 관리할 수 있습니다. Digital Ocean 제어판에서 익숙한 모든 기능은 API를 통해서도 사용할 수 있으므로 상황에 따라 복잡한 작업을 스크립트로 작성할 수 있습니다.

이 튜토리얼에서는 개발자 Antoine Corcy의 Digital Ocean V2 PHP API 라이브러리를 Yii 기반 콘솔 애플리케이션에 통합합니다. 이 애플리케이션을 사용하기 위해 Yii를 알 필요는 없지만 Yii 프레임워크 소개에서 자세한 내용을 알아볼 수 있습니다.

Digital Ocean API는 OAuth를 통해 귀하의 계정을 인증하며 거의 12개의 프리미엄 영역으로 구성됩니다.

• Account: Digital Ocean 계정에 대한 기본 정보를 제공하세요.
• Operations: 귀하의 계정에 있는 Droplets의 작업 내역 로그입니다.
• 도메인 이름 및 도메인 레코드: 계정의 드롭릿에 사용된 도메인 이름과 이와 관련된 DNS 레코드를 관리할 수 있습니다.
• Droplet 및 Droplet Actions: Droplet에 대한 생성, 종료, 다시 시작, 스냅샷 등을 수행할 수 있습니다.
• 이미지 및 이미지 작업: 계정에서 Droplet용으로 촬영한 스냅샷 이미지를 열거하고 관리할 수 있습니다.
• SSH Keys: 드롭릿 생성 시 설치용 SSH 키를 등록할 수 있어 비밀번호 보안이 필요하지 않습니다.
• Region: 디지털 해양 방울이 생성될 수 있는 지리적 영역을 열거합니다.
• Sizes: 물방울을 만들 때 사용할 수 있는 물방울 크기를 열거합니다.

이제 API에 대해 알았으니 자체 애플리케이션을 살펴보겠습니다.

액세스 키 설정

API를 사용하려면 계정에 대한 개인 액세스 토큰을 활성화해야 합니다. 계정에 로그인하고 설정 애플리케이션 페이지(https://cloud.digitalocean.com/settings/applications)를 방문하세요. 아래와 같이 를 클릭하여 새 토큰 을 생성합니다.

아래에 액세스 토큰을 적어주세요. Digital Ocean에서는 한 번만 표시됩니다.

이제 샘플 콘솔 애플리케이션으로 이동해 보겠습니다.

저희 콘솔 앱

이 튜토리얼에서는 Droplet 관리와 관련된 몇 가지 작업을 수행하기 위해 제가 만든 작은 콘솔 애플리케이션을 살펴보겠습니다. Tuts+ GitHub 저장소에서 애플리케이션을 직접 설치하고 이를 사용자 정의하거나 확장하여 원하는 추가 API 기능을 구현할 수 있습니다. 내 웹 사이트에 콘솔 응용 프로그램에 대한 자세한 설치 안내서를 게시했습니다. Digital Ocean 앱에 대한 일반 설치 가이드를 찾아볼 수도 있습니다.

API 액세스 구성

우리는 다시 Antoine Corcy의 Digital Ocean V2 PHP API 라이브러리를 사용하여 API에 액세스하고 있습니다.

우리는 그의 라이브러리 사용을 위한 모델 역할을 하는 Ocean.php라는 구성 요소를 만들었습니다. /app/protected/components/Ocean.php에 위치해 있습니다.

Yii는 Ocean.ini 파일에서 액세스 토큰을 로드하고(Digital Ocean 콘솔 응용 프로그램 설치 가이드에 설명된 대로) digitalOcean API 개체를 인스턴스화합니다.

으아아아

물방울 받기

이제 활성 Droplet 목록을 가져오겠습니다. /app/protected/models/Droplet.php 中，我们的 sync 메서드에서 Ocean 구성 요소를 호출하고 Droplet을 가져옵니다.

으아아아

바다 getDroplets 방법은 다음과 같습니다.

으아아아

참고: 기본 콘솔 앱은 드롭릿 목록의 단방향 다운로드 동기화만 수행합니다. 클라우드에서 삭제된 드롭을 삭제하는 등 더 많은 기능을 직접 구현할 수 있습니다.

이것은 Droplet 모델의 add 기능입니다. 드롭릿이 이미 존재하는 경우 레코드를 업데이트합니다.

public function add($droplet) {
     $d = Droplet::model()->findByAttributes(array('droplet_id'=>$droplet->id));
    if (empty($d)) {
      $d = new Droplet;
    }
    $d->user_id = Yii::app()->user->id;
      $d->droplet_id = $droplet->id;
      $d->name = $droplet->name;
      $d->vcpus = $droplet->vcpus;
      $d->memory = $droplet->memory;
      $d->disk = $droplet->disk;
      $d->status = $droplet->status;
      $d->active =1;
     $d->created_at = $d->created_at;
     $d->modified_at =new CDbExpression('NOW()');          
     $d->save();
    return $d->id;
   }

如果您希望扩展模型的功能，Digital Ocean 提供了各种 Droplet API 操作，Corcy 在此列出了清晰的示例。

获取图像

接下来，我们将使用 API 来获取当前图像的列表。映像是快照，本质上是备份，是在给定时间点从服务器实例获取的。

我们的 Snapshot.php 模型有一个 sync 操作，它会请求图像列表并添加将它们分别写入数据库：

   public function sync() {
     $ocean = new Ocean();
     $snapshots = $ocean->getSnapshots();
     foreach ($snapshots as $i) {
       $image_id = $this->add($i);
       if ($image_id!==false) {
         echo $image_id;lb();
         pp($i);        
       }
     }          
   }

这是海洋组件 getSnapshots 代码：

  public function getSnapshots() {
    // return the action api
    $action  = $this->digitalOcean->image();
    // return a collection of Action entity
    $actions = $action->getAll();    
    return $actions;
  }

这是快照模型 add 代码 - 我们忽略 Digital Ocean 的库存应用程序映像，这些映像被区分为公共：

   public function add($snapshot) {
      $i = Snapshot::model()->findByAttributes(array('image_id'=>$snapshot->id));
     if (empty($i)) {
       $i = new Snapshot;
       $i->created_at =new CDbExpression('NOW()');          
     }
     if (isset($snapshot->public) and $snapshot->public ==1) {
       return false; // no need to save public images right now
     } else 
       $i->user_id = Yii::app()->user->id;       
       $i->image_id = $snapshot->id;
       $i->name = $snapshot->name;
       $i->region = $snapshot->regions[0];
       $i->active =1;
       $i->modified_at =new CDbExpression('NOW()');          
      $i->save();
    return $i->id;
    }	

自动化快照

正如我们在构建要在 Digital Ocean 进行转售的应用映像中所讨论的那样，自动创建可传输给客户和顾客的快照非常有用。遗憾的是，目前无法通过引用克隆或传输图像；每次您将快照转移到另一个帐户时，它就会消失。

由于 Digital Ocean 要求您将图像实例化为 Droplet，并在拍摄新快照之前将其关闭，因此重复创建快照是一个耗时的手动过程。 Digital Ocean 在拍摄快照后再次启动水滴并没有什么帮助，这只会减慢进程。

由于 API 在其他操作挂起时不接受请求，因此我们必须构建一个表来跟踪后台操作并使用 cron 作业来重复断电、快照操作。其工作原理如下：

访问图像页面，然后单击您想要克隆的快照的查看。然后，单击右侧的复制菜单选项。

这将创建一个 Droplet 并使用此 image_id 和droplet_id。 end_stage 是一个常量，您可以设置它来指示要创建的重复项的数量。

这是 Snapshot 模型的 replicate() 方法：

    public function replicate($id) {
        // look up image_id
      $snapshot = Snapshot::model()->findByAttributes(array('id'=>$id));
  	  // create the droplet 
      $ocean = new Ocean();
      $droplet_id = $ocean->launch_droplet($snapshot->name,$snapshot->region,$snapshot->image_id);
  	  // add command to action table with droplet_id and image_id
      $a = new Action();
      $a->droplet_id = $droplet_id;
      $a->snapshot_id = $snapshot->image_id;
      $a->action = Action::ACTION_SNAPSHOT;
      $a->status = Action::STATUS_ACTIVE;
      $a->stage = 0;
    // user settable constant for number of replications to make
      $a->end_stage = Snapshot::NUMBER_REPLICATIONS;
      $a->last_checked = 0;
      $a->modified_at =new CDbExpression('NOW()');          
      $a->created_at =new CDbExpression('NOW()');          
      $a->save(); 
    }

cron 任务将 ping http://ocean.yourdomain.com/daemon/index 以定期处理操作表。任何未完成的逾期项目都将请求另一个快照。

这是 Action 模型的 process() 方法：

    public function process() {
	  set_time_limit(0);
	  // look for overdue actions	  
	  $todo = Action::model()->overdue()->findAllByAttributes(array('status'=>self::STATUS_ACTIVE));
	  foreach ($todo as $item) {
	    if ($item->action == self::ACTION_SNAPSHOT) {
          $result = Snapshot::model()->take($item->id);          
	    }
	  }
	}

快照过程将关闭 Droplet，暂停 20 秒等待 Droplet 关闭，并请求快照。

这是 Snapshot 模型的 take() 方法：

 public function take($action_id) {
    $result = false;
      $a = Action::model()->findByPk($action_id);
    $snapshot = Snapshot::model()->findByAttributes(array('image_id'=>$a->snapshot_id));
    $ocean = new Ocean();
    // attempt shutdown
    // take snapshot
    $result = $ocean->snapshot($a->stage,$a->droplet_id,$snapshot->name,$snapshot->region,$snapshot->image_id);
    // if snapshot was successful
    if ($result) {
      // increment stage
      $a->stage+=1;
      // if last snapshot replication complete, end action
      if ($a->stage >= $a->end_stage)  
        $a->status = Action::STATUS_COMPLETE;
    } 
	  // either way, update last_checked
    $a->last_checked = time();
    $a->save();              
	  return $result;
  }

以下是 Ocean 组件中用于实际进行 API 调用的代码：

public function snapshot($stage,$droplet_id,$name,$region,$image_id,$begin=1,$count=3,$size='512mb') {
    $no_sleep = false;
    $name = str_replace("_","-",$name);
    $droplet  = $this->digitalOcean->droplet();
      try {
        echo 'Shutting down '.$droplet_id;lb();
        $shutdown = $droplet->shutdown($droplet_id);
      } catch (Exception $e) {
          $err = $e->getMessage();
          echo 'Caught exception: ',  $e->getMessage(), "\n";
          if (stristr ( $err , 'already powered off')===false)
            return false;
          else
            $no_sleep = true;
      }
    if (!$no_sleep) {
      echo 'Sleep 20 seconds for power off...';lb();
      sleep(20);              
    }
    echo 'Take snapshot of '.$droplet_id.' named '.$name.'-copy-'.$stage;lb();
    try {
      $snapshot = $droplet->snapshot($droplet_id, $name.'-copy-'.$stage); 
    } catch (Exception $e) {
        echo 'Caught exception: ',  $e->getMessage(), "\n";
        return false;
    }
    // shutdown and snapshot successful
    return true;
  }

如果您访问 Digital Ocean 网站查看 Droplet，您将看到正在进行的操作：

如果快照成功，则返回Snapshot模型以递增阶段。当阶段复制完成后，操作完成。

您可以访问 Digital Ocean 网站的图像页面来查看复制的快照：

创建图像后，您可以手动删除 Droplet，或者您可以扩展代码以在 STATUS_COMPLETE 已达到。如果您不删除 Droplet，我们将向您收取费用。

请注意，目前 API 不提供将快照传输到电子邮件地址的功能，因此您需要继续通过网络界面手动执行此操作。

下一步是什么？

我希望您喜欢本教程，并发现 Digital Ocean 是您的工具和托管提供商组合中的一项有用服务。在下一个教程中，我们将探索 Digital Ocean DNS 服务。

请随时在下面发表您的问题和评论。您也可以通过 Twitter @reifman 联系我或直接给我发电子邮件。请关注我的 Tuts+ 讲师页面，查看本系列后续文章。

相关链接

• 数字海洋 API
• Digital Ocean V2 PHP API 库
• 数字海洋控制台应用程序安装指南

위 내용은 Digital Ocean API를 사용하여 클라우드 인스턴스 관리의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!