サイトを追加する

このチュートリアルでは、Pulumi Infrastructure as Code (IaC) を使用して既存のサイトを Cloudflare に移行するための手順を段階的に説明します。これにより、リソース管理ライフサイクルに慣れることができます。特に、ゾーンと新しく追加したサイトを解決するための DNS レコードを作成します。このチュートリアルは、サイトを追加するチュートリアル に記載された手順を完了するために IaC の原則を採用しています。

ノート

Pulumi Cloud と Cloudflare の両方の無料枠の提供に該当するリソースをプロビジョニングします。

始める前に

以下を確認してください：

• このチュートリアルのリソースを編集する権限を持つ Cloudflare アカウントと API トークン。必要に応じて、Cloudflare アカウント ↗にサインアップしてください。トークンには以下の権限が必要です：
  • Zone-Zone-Edit 権限
  • Zone-DNS-Edit 権限
  • include-All zones from an account-<your account> ゾーンリソース
• Pulumi Cloud アカウント。常に無料の個人プランにサインアップできます。こちらから ↗。
• Pulumi CLI がマシンにインストールされていること。
• Pulumi がサポートするプログラミング言語 ↗が設定されていること。（TypeScript、JavaScript、Python、Go、.NET、Java、または YAML を使用）
• ドメイン名。チュートリアルを完了するために example.com を使用できます。

Pulumi を初期化する

a. ディレクトリを作成する

このチュートリアル用に新しく空のディレクトリを使用します。

mkdir addsite-cloudflare
cd addsite-cloudflare

b. ログインする

プロンプトで Enter を押して、ブラウザを介して Pulumi Cloud アカウントにログインします。あるいは、Pulumi Cloud アクセストークン ↗を提供することもできます。

pulumi login

c. プログラムを作成する

ノート

Pulumi プログラムは、インフラストラクチャリソースを定義するために書かれた サポートされているプログラミング言語 ↗ のコードです。

プログラムを作成するには、希望する言語を選択し、pulumi コマンドを実行します：

JavaScript

pulumi new javascript --name addsite-cloudflare --yes
# プロジェクトが初期化されるまで数秒待ちます

TypeScript

pulumi new typescript --name addsite-cloudflare --yes
# プロジェクトが初期化されるまで数秒待ちます

Python

pulumi new python --name addsite-cloudflare --yes
# プロジェクトが初期化されるまで数秒待ちます

go

pulumi new go --name addsite-cloudflare --yes
# プロジェクトが初期化されるまで数秒待ちます

Java

pulumi new java --name addsite-cloudflare --yes
# プロジェクトが初期化されるまで数秒待ちます

.NET

pulumi new csharp --name addsite-cloudflare --yes
# プロジェクトが初期化されるまで数秒待ちます

YAML

pulumi new yaml --name addsite-cloudflare --yes

d. 設定を保存する

以下が必要です：

• Cloudflare の アカウント ID。
• 有効な Cloudflare API トークン。
• ドメイン。例えば、example.com。

ノート

Pulumi ESC 環境 ↗は、アプリケーションとインフラストラクチャに関連する設定とシークレットを含む YAML ファイルです。これらは、Pulumi プログラムを含むいくつかの方法でアクセスできます。すべての ESC 環境は、Pulumi Cloud アカウントに存在します。

# ESC 環境名を定義する
E=my-dev-env

# 新しい Pulumi ESC 環境を作成する
pulumi config env init --env $E --yes --stack dev

# API_TOKEN を Cloudflare API トークンに置き換える
pulumi env set $E --secret  pulumiConfig.cloudflare:apiToken API_TOKEN

# abc123 を Cloudflare アカウント ID に置き換える
pulumi env set $E --plaintext pulumiConfig.accountId abc123

# example.com を登録済みのドメインに置き換えるか、そのままにする
pulumi env set $E --plaintext pulumiConfig.domain example.com

# ESC 環境を確認する
pulumi env open $E
{
  "pulumiConfig": {
    "accountId": "111222333",
    "cloudflare:apiToken": "abc123abc123",
    "domain": "example.com"
  }
}

e. スタックを作成する

ノート

Pulumi の スタック ↗は、Pulumi プログラムのインスタンスです。スタックは独立して構成可能で、異なる環境（開発、ステージング、本番）や機能ブランチを表すことができます。このチュートリアルでは、dev スタックを使用します。

dev スタックをインスタンス化するには、次のコマンドを実行します：

pulumi up --yes --stack dev
# スタックがインスタンス化されるまで数秒待ちます。

この時点では、リソースを定義していないため、空のスタックになります。

ゾーンを追加する

ノート

ドメインまたはサイトは、Cloudflare ではゾーンとして知られています。

これから、Pulumi Cloudflare パッケージと Cloudflare ゾーンリソースを Pulumi プログラムに追加します。

a. 依存関係をインストールする

JavaScript

npm install @pulumi/cloudflare

added 1 package ...

TypeScript

npm install @pulumi/cloudflare

added 1 package ...

Python

echo "pulumi_cloudflare>=5.35,<6.0.0" >> requirements.txt
source venv/bin/activate
pip install -r requirements.txt

...
Collecting pulumi-cloudflare
...

go

go get github.com/pulumi/pulumi-cloudflare/sdk/v3/go/cloudflare

go: downloading github.com/pulumi/pulumi-cloudflare ...

Java

以下は Apache Maven の手順です。他の Java プロジェクトマネージャー（Gradle など）については、公式の Maven リポジトリ ↗を参照してください。

1. pom.xml ファイルを開きます。
2. <dependencies> セクション内に Pulumi Cloudflare 依存関係を追加します。

<dependency>
    <groupId>com.pulumi</groupId>
    <artifactId>cloudflare</artifactId>
    <version>5.35.1</version>
</dependency>

1. 次のコマンドを実行します：

mvn clean install

...
[INFO] BUILD SUCCESS
...

.NET

dotnet add package Pulumi.Cloudflare

...
info : Adding PackageReference for package 'Pulumi.Cloudflare' into project
...

YAML

YAML にはダウンロードする依存関係はありません。スキップしてください。

b. プログラムを修正する

エントリポイントファイルの内容を以下のように置き換えます：

JavaScript

"use strict";
const pulumi = require("@pulumi/pulumi");
const cloudflare = require("@pulumi/cloudflare");

const config = new pulumi.Config();
const accountId = config.require("accountId");
const domain = config.require("domain");

// Cloudflare リソース（ゾーン）を作成する
const zone = new cloudflare.Zone("my-zone", {
  zone: domain,
  accountId: accountId,
  plan: "free",
  jumpStart: true,
});

// ゾーン ID をエクスポートする
exports.zoneId = zone.id;

TypeScript

import * as pulumi from "@pulumi/pulumi";
import * as cloudflare from "@pulumi/cloudflare";

const config = new pulumi.Config();
const accountId = config.require("accountId");
const domain = config.require("domain");

// Cloudflare リソース（ゾーン）を作成する
const zone = new cloudflare.Zone("my-zone", {
  zone: domain,
  accountId: accountId,
  plan: "free",
  jumpStart: true,
});

// ゾーン ID をエクスポートする
export const zoneId = zone.id;

Python

import pulumi
import pulumi_cloudflare as cloudflare

account_id = pulumi.Config().require("accountId")
domain = pulumi.Config().require("domain")

# Cloudflare リソース（ゾーン）を作成する
zone = cloudflare.Zone("my-zone",
    zone=domain,
    account_id=account_id,
    plan="free",
    jump_start=True)

# ゾーン ID をエクスポートする
pulumi.export("zoneId", zone.id)

go

package main

import (
    "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    cloudflare "github.com/pulumi/pulumi-cloudflare/sdk/v3/go/cloudflare"
)

func main() {
    pulumi.Run(func(ctx *pulumi.Context) error {
        domain, _ := ctx.GetConfig("domain")

        // Cloudflare リソース（ゾーン）を作成する
        zone, err := cloudflare.NewZone(ctx, "my-zone", &cloudflare.ZoneArgs{
            Zone:      pulumi.String(domain),
            Plan:      pulumi.String("free"),
            JumpStart: pulumi.Bool(true),
        })
        if err != nil {
            return err
        }

        // ゾーン ID をエクスポートする
        ctx.Export("zoneId", zone.ID())
        return nil
    })
}

Java

エントリポイントファイルは src/main/java/myproject ディレクトリにあります。

package myproject;

import com.pulumi.Pulumi;
import com.pulumi.Context;
import com.pulumi.cloudflare.ZoneArgs;
import com.pulumi.cloudflare.Zone;


public class App {
    public static void main(String[] args) {
        Pulumi.run(ctx -> {
            var config = ctx.config();

            String accountId = config.require("accountId");
            String domain = config.require("domain");

            var zone = new Zone("my-zone", ZoneArgs.builder()
                .zone(domain)
                .accountId(accountId)
                .plan("free")
                .jumpStart(true)
                .build());

            ctx.export("zoneId", zone.id());
        });
    }
}

.NET

using System.Threading.Tasks;
using Pulumi;
using Pulumi.Cloudflare;

class Program
{
    static Task<int> Main() => Deployment.RunAsync<MyStack>();

    class MyStack : Stack
    {
        public MyStack()
        {
            var config = new Pulumi.Config();
            var accountId = config.Require("accountId");
            var domain = config.Require("domain");

            var zone = new Zone("my-zone", new ZoneArgs
            {
                ZoneName = domain,
                AccountId = accountId,
                Plan = "free",
                JumpStart = true
            });

            this.ZoneId = zone.Id;
        }

        [Output]
        public Output<string> ZoneId { get; set; }
    }
}

YAML

environment:
  - my-dev-env

resources:
  myZone:
    type: cloudflare:Zone
    properties:
      zone: ${domain}
      accountId: ${accountId}
      plan: "free"
      jumpStart: true

outputs:
  zoneId: ${myZone.id}

c. 変更を適用する

pulumi up --yes --stack dev
# 変更が適用されるまで数秒待ちます

d. （オプション）ゾーンを確認する

ゾーン作成を確認するために zoneId の値を確認します。

pulumi stack output zoneId

d8fcb6d731fe1c2d75e2e8d6ad63fad5

ネームサーバーを更新する

Cloudflare にドメインを追加すると、そのドメインには 2 つの割り当てられた権限のあるネームサーバーが割り当てられます。

ノート

このプロセスにより、Cloudflare があなたの権限のある DNS プロバイダーとなり、あなたの DNS クエリとウェブトラフィックが Cloudflare ネットワークから提供され、保護されるようになります。

保留中のドメインについて詳しく学ぶ

a. プログラムを更新する

エントリポイントファイルの最後に、zoneId 変数の下に以下を追加します：

JavaScript

exports.nameservers = zone.nameServers;
exports.status = zone.status;

TypeScript

export const nameservers = zone.nameServers;
export const status = zone.status;

Python

pulumi.export('nameservers', zone.name_servers)
pulumi.export('status', zone.status)

go

ctx.Export("nameservers", zone.NameServers)
ctx.Export("status", zone.Status)

Java

ctx.export("nameservers", zone.nameServers());
ctx.export("status", zone.status());

.NET

1. Program.cs ファイルの先頭に using System.Collections.Immutable; を追加します。
2. this.ZoneId = zone.Id; の下に、以下を追加します：

this.Nameservers = zone.NameServers;
this.Status = zone.Status;

3. public Output<string> ZoneId { get; set; } の下に、以下を追加します：

public Output<ImmutableArray<string>> Nameservers { get; set; }
public Output<string> Status { get; set; }

YAML

nameservers: ${exampleZone.nameServers}
status: ${exampleZone.status}

b. 変更を適用する

pulumi up --yes --stack dev

c. ネームサーバーを取得する

割り当てられたネームサーバーを取得するために nameservers の値を確認します：

pulumi stack output --stack dev

d. レジストラを更新する

ノート

サイトとして example.com を使用している場合は、DNS レコードを追加する に進んでください。

ドメインのCloudflareサービスを有効にするために、レジストラでネームサーバーを更新してください。手順はレジストラごとに異なります。この一般的なレジストラの統合リストの下にガイダンスが見つかるかもしれません。

注意

レジストラはネームサーバーの変更を処理するのに最大24時間かかることがあります。

e. ドメインのステータスを確認する

正常に登録されると、ドメインのstatusはactiveに変更されます。

pulumi stack output

DNSレコードを追加する

これからドメインにDNSレコードを追加します。

a. プログラムを修正する

以下は、Pulumiプログラムのエントリポイントファイルの最終バージョンです。 エントリポイントファイルの内容を以下のように置き換えてください。

JavaScript

"use strict";
const pulumi = require("@pulumi/pulumi");
const cloudflare = require("@pulumi/cloudflare");

const config = new pulumi.Config();
const accountId = config.require("accountId");
const domain = config.require("domain");

// Cloudflareリソース（ゾーン）を作成
const zone = new cloudflare.Zone("my-zone", {
  zone: domain,
  accountId: accountId,
  plan: "free",
  jumpStart: true,
});

// ゾーンIDをエクスポート
exports.zoneId = zone.id;
exports.nameservers = zone.nameServers;
exports.status = zone.status;

const record = new cloudflare.Record("my-record", {
  zoneId: zone.id,
  name: domain,
  value: "192.0.2.1",
  type: "A",
  proxied: true,
});

TypeScript

import * as pulumi from "@pulumi/pulumi";
import * as cloudflare from "@pulumi/cloudflare";

const config = new pulumi.Config();
const accountId = config.require("accountId");
const domain = config.require("domain");

// Cloudflareリソース（ゾーン）を作成
const zone = new cloudflare.Zone("my-zone", {
  zone: domain,
  accountId: accountId,
  plan: "free", // 希望するプランを選択、例: "free", "pro", "business" など
  jumpStart: true,
});

// ゾーンIDをエクスポート
export const zoneId = zone.id;

// Cloudflareが割り当てたネームサーバーをエクスポート
export const nameservers = zone.nameServers;

// ステータスをエクスポート
export const status = zone.status;

// サイトのためのレコードを設定
const record = new cloudflare.Record("my-record", {
  zoneId: zoneId,
  name: domain,
  value: "192.0.2.1",
  type: "A",
  proxied: true,
});

Python

import pulumi
import pulumi_cloudflare as cloudflare

account_id = pulumi.Config().require("accountId")
domain = pulumi.Config().require("domain")

# Cloudflareリソース（ゾーン）を作成
zone = cloudflare.Zone("my-zone",
    zone=domain,
    account_id=account_id,
    plan="free",
    jump_start=True)

# ゾーンIDをエクスポート
pulumi.export("zoneId", zone.id)
pulumi.export('nameservers', zone.name_servers)
pulumi.export('status', zone.status)

record = cloudflare.Record("my-record",
    zone_id=zone.id,
    name=domain,
    value="192.0.2.1",
    type="A",
    proxied=True
)

go

package main

import (
  cloudflare "github.com/pulumi/pulumi-cloudflare/sdk/v3/go/cloudflare"
  "github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
  pulumi.Run(func(ctx *pulumi.Context) error {
    domain, _ := ctx.GetConfig("domain")

    // Cloudflareリソース（ゾーン）を作成
    zone, err := cloudflare.NewZone(ctx, "my-zone", &cloudflare.ZoneArgs{
      Zone:      pulumi.String(domain),
      Plan:      pulumi.String("free"),
      JumpStart: pulumi.Bool(true),
    })
    if err != nil {
      return err
    }

    // ゾーンIDをエクスポート
    ctx.Export("zoneId", zone.ID())
    ctx.Export("nameservers", zone.NameServers)
    ctx.Export("status", zone.Status)

    _, err = cloudflare.NewRecord(ctx, "my-record", &cloudflare.RecordArgs{
      ZoneId:  zone.ID(),
      Name:    pulumi.String(domain),
      Value:   pulumi.String("192.0.2.1"),
      Type:    pulumi.String("A"),
      Proxied: pulumi.Bool(true),
    })
    if err != nil {
      return err
    }

    return nil
  })
}

Java

package myproject;

import com.pulumi.Pulumi;
import com.pulumi.Context;
import com.pulumi.cloudflare.ZoneArgs;
import com.pulumi.cloudflare.Zone;
import com.pulumi.cloudflare.Record;
import com.pulumi.cloudflare.RecordArgs;


public class App {
    public static void main(String[] args) {
        Pulumi.run(ctx -> {
            var config = ctx.config();

            String accountId = config.require("accountId");
            String domain = config.require("domain");

            var zone = new Zone("my-zone", ZoneArgs.builder()
                .zone(domain)
                .accountId(accountId)
                .plan("free")
                .jumpStart(true)
                .build());

            ctx.export("zoneId", zone.id());
            ctx.export("nameservers", zone.nameServers());
            ctx.export("status", zone.status());

            new Record("my-record", RecordArgs.builder()
            .zoneId(zone.id())
            .name(domain)
            .value("192.0.2.1")
            .type("A")
            .proxied(true)
            .build());
        });
    }
}

.NET

using System.Collections.Immutable;
using System.Threading.Tasks;
using Pulumi;
using Pulumi.Cloudflare;

class Program
{
    static Task<int> Main() => Deployment.RunAsync<MyStack>();

    class MyStack : Stack
    {
        public MyStack()
        {
            var config = new Pulumi.Config();
            var accountId = config.Require("accountId");
            var domain = config.Require("domain");

            var zone = new Zone("my-zone", new ZoneArgs
            {
                ZoneName = domain,
                AccountId = accountId,
                Plan = "free",
                JumpStart = true
            });

            this.ZoneId = zone.Id;
            this.Nameservers = zone.NameServers;
            this.Status = zone.Status;

            new Record("my-record", new RecordArgs
            {
                ZoneId = zone.Id,
                Name = domain,
                Value = "192.0.2.1",
                Type = "A",
                Proxied = true
            });

        }

        [Output]
        public Output<string> ZoneId { get; set; }
        public Output<ImmutableArray<string>> Nameservers { get; set; }
        public Output<string> Status { get; set; }
    }
}

YAML

environment:
  - my-dev-env

resources:
  myZone:
    type: cloudflare:Zone
    properties:
      zone: ${domain}
      accountId: ${accountId}
      plan: "free"
      jumpStart: true

  myRecord:
    type: cloudflare:Record
    properties:
      zoneId: ${myZone.id}
      name: ${domain}
      value: 192.0.2.1
      type: A
      proxied: true
outputs:
  zoneId: ${myZone.id}
  nameservers: ${exampleZone.nameServers}
  status: ${exampleZone.status}

b. 変更を適用する

pulumi up --yes --stack dev

セットアップを確認する

Cloudflareが割り当てたネームサーバーに対して2つのnslookupコマンドを実行します。

サイトをテストするには、次のコマンドを実行します：

DOMAIN=$(pulumi config get domain)
NS1=$(pulumi stack output nameservers | jq '.[0]' -r)
NS2=$(pulumi stack output nameservers | jq '.[1]' -r)
nslookup $DOMAIN $NS1
nslookup $DOMAIN $NS2

.NETの場合は、NameserversをOutputとして使用します。

応答がサイトのIPアドレスを返すことを確認してください。

クリーンアップ

この最後のステップでは、チュートリアル全体で使用したリソースとスタックを削除します。

a. リソースを削除する

pulumi destroy --yes

b. スタックを削除する

pulumi stack rm dev

Cloudflareにサイトを追加するために必要なリソースを段階的に定義しました。新しいリソースごとに、pulumi upコマンドを使用してdevスタックに変更を適用します。選択したプログラミング言語でリソースを宣言し、Pulumiが残りを処理します。

次のステップ

Hello Worldチュートリアルに従って、Pulumiを使用してサーバーレスアプリをデプロイしてください。