@checkly/pulumi 0.0.1-alpha.4 → 0.0.1-alpha.6

package/README.md

@@ -1,8 +1,7 @@
-**⚠️ This project is still in very early stages and breaking changes could happen**
-
 # Checkly Pulumi Provider
 
 The Checkly Pulumi provider enables you to create and configure Checkly resources using your favourite programming language.
+Note that this project is in its early stages and breaking changes could happen.
 
 ## Installation
 
@@ -26,7 +25,7 @@ yarn add @checkly/pulumi
 Install the provider binary plugin. This is only needed due to an outstanding bug in with Pulumi registry
 
 ```bash
-pulumi plugin install resource checkly v0.0.1-alpha.1 --server https://github.com/checkly/pulumi-checkly/releases/download/v0.0.1-alpha.1
+pulumi plugin install resource checkly v0.0.1-alpha.5 --server https://github.com/checkly/pulumi-checkly/releases/download/v0.0.1-alpha.5
 ```
 
 ### Python, Go & .NET

package/alertChannel.ts

@@ -6,133 +6,68 @@ import { input as inputs, output as outputs } from "./types";
 import * as utilities from "./utilities";
 
 /**
- * ## # checkly.AlertChannel
- *
- * The `checkly.AlertChannel` resource allows users to manage Checkly alert channels.
- *
- * Checkly's Alert Channels feature allows you to define global alerting channels for the checks in your account:
+ * Allows you to define alerting channels for the checks and groups in your account
  *
  * ## Example Usage
  *
- * *An Email alert channel*
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";
- * import * as checkly from "@pulumi/checkly";
+ * import * as pulumi from "@checkly/pulumi";
  *
- * const emailAc = new checkly.AlertChannel("email_ac", {
+ * // An Email alert channel
+ * const emailAc = new checkly.AlertChannel("emailAc", {
  *     email: {
  *         address: "john@example.com",
  *     },
- *     sendDegraded: true,
- *     sendFailure: false,
  *     sendRecovery: true,
+ *     sendFailure: false,
+ *     sendDegraded: true,
  *     sslExpiry: true,
  *     sslExpiryThreshold: 22,
  * });
- * ```
- *
- * *A SMS alert channel*
- * ```typescript
- * import * as pulumi from "@pulumi/pulumi";
- * import * as checkly from "@pulumi/checkly";
- *
- * const smsAc = new checkly.AlertChannel("sms_ac", {
- *     sendFailure: true,
- *     sendRecovery: true,
+ * // A SMS alert channel
+ * const smsAc = new checkly.AlertChannel("smsAc", {
  *     sms: {
  *         name: "john",
- *         number: "0123456789",
- *     },
- * });
- * ```
- *
- * *A Slack alert channel*
- * ```typescript
- * import * as pulumi from "@pulumi/pulumi";
- * import * as checkly from "@pulumi/checkly";
- *
- * const slackAc = new checkly.AlertChannel("slack_ac", {
- *     slack: {
- *         channel: "#checkly-notifications",
- *         url: "https://slack.com/webhook",
- *     },
- * });
- * ```
- *
- * *An Opsgenie alert channel*
- * ```typescript
- * import * as pulumi from "@pulumi/pulumi";
- * import * as checkly from "@pulumi/checkly";
- *
- * const opsgenieAc = new checkly.AlertChannel("opsgenie_ac", {
- *     opsgenie: {
- *         apiKey: "fookey",
- *         name: "opsalerts",
- *         priority: "foopriority",
- *         region: "fooregion",
- *     },
- * });
- * ```
- *
- * *An Pagerduty alert channel*
- * ```typescript
- * import * as pulumi from "@pulumi/pulumi";
- * import * as checkly from "@pulumi/checkly";
- *
- * const pagerdutyAc = new checkly.AlertChannel("pagerduty_ac", {
- *     pagerduty: {
- *         account: "checkly",
- *         serviceKey: "key1",
- *         serviceName: "pdalert",
- *     },
- * });
- * ```
- *
- * *An Webhook alert channel*
- * ```typescript
- * import * as pulumi from "@pulumi/pulumi";
- * import * as checkly from "@pulumi/checkly";
- *
- * const webhookAc = new checkly.AlertChannel("webhook_ac", {
- *     webhook: {
- *         method: "get",
- *         name: "foo",
- *         template: "footemplate",
- *         url: "http://example.com/foo",
- *         webhookSecret: "foosecret",
+ *         number: "+5491100001111",
  *     },
+ *     sendRecovery: true,
+ *     sendFailure: true,
  * });
- * ```
- *
- * *Connecting the alert channel to a check
- * ```typescript
- * import * as pulumi from "@pulumi/pulumi";
- * import * as pulumi from "@checkly/pulumi";
- *
+ * // A Slack alert channel
+ * const slackAc = new checkly.AlertChannel("slackAc", {slack: {
+ *     channel: "#checkly-notifications",
+ *     url: "https://slack.com/webhook",
+ * }});
+ * // An Opsgenie alert channel
+ * const opsgenieAc = new checkly.AlertChannel("opsgenieAc", {opsgenie: {
+ *     name: "opsalerts",
+ *     apiKey: "fookey",
+ *     region: "fooregion",
+ *     priority: "foopriority",
+ * }});
+ * // An Pagerduty alert channel
+ * const pagerdutyAc = new checkly.AlertChannel("pagerdutyAc", {pagerduty: {
+ *     account: "checkly",
+ *     serviceKey: "key1",
+ *     serviceName: "pdalert",
+ * }});
+ * // An Webhook alert channel
+ * const webhookAc = new checkly.AlertChannel("webhookAc", {webhook: {
+ *     name: "foo",
+ *     method: "get",
+ *     template: "footemplate",
+ *     url: "https://example.com/foo",
+ *     webhookSecret: "foosecret",
+ * }});
+ * // Connecting the alert channel to a check
  * const example_check = new checkly.Check("example-check", {alertChannelSubscriptions: [
  *     {
- *         channelId: checkly_alert_channel.email_ac.id,
+ *         channelId: emailAc.id,
  *         activated: true,
  *     },
  *     {
- *         channelId: checkly_alert_channel.sms_ac.id,
- *         activated: true,
- *     },
- * ]});
- * ```
- *
- * *Connecting the alert channel to a check group
- * ```typescript
- * import * as pulumi from "@pulumi/pulumi";
- * import * as pulumi from "@checkly/pulumi";
- *
- * const test_group1 = new checkly.CheckGroup("test-group1", {alertChannelSubscriptions: [
- *     {
- *         channelId: checkly_alert_channel.email_ac.id,
- *         activated: true,
- *     },
- *     {
- *         channelId: checkly_alert_channel.sms_ac.id,
+ *         channelId: smsAc.id,
  *         activated: true,
  *     },
  * ]});
@@ -166,35 +101,29 @@ export class AlertChannel extends pulumi.CustomResource {
         return obj['__pulumiType'] === AlertChannel.__pulumiType;
     }
 
-    /**
-     * :
-     */
     public readonly email!: pulumi.Output<outputs.AlertChannelEmail | undefined>;
     public readonly opsgenie!: pulumi.Output<outputs.AlertChannelOpsgenie | undefined>;
     public readonly pagerduty!: pulumi.Output<outputs.AlertChannelPagerduty | undefined>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `false`)
      */
     public readonly sendDegraded!: pulumi.Output<boolean | undefined>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `true`)
      */
     public readonly sendFailure!: pulumi.Output<boolean | undefined>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `true`)
      */
     public readonly sendRecovery!: pulumi.Output<boolean | undefined>;
     public readonly slack!: pulumi.Output<outputs.AlertChannelSlack | undefined>;
-    /**
-     * :
-     */
     public readonly sms!: pulumi.Output<outputs.AlertChannelSms | undefined>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `false`)
      */
     public readonly sslExpiry!: pulumi.Output<boolean | undefined>;
     /**
-     * . Possible values between 1 and 30. Default is `30`.
+     * Value must be between 1 and 30 (Default `30`)
      */
     public readonly sslExpiryThreshold!: pulumi.Output<number | undefined>;
     public readonly webhook!: pulumi.Output<outputs.AlertChannelWebhook | undefined>;
@@ -246,35 +175,29 @@ export class AlertChannel extends pulumi.CustomResource {
  * Input properties used for looking up and filtering AlertChannel resources.
  */
 export interface AlertChannelState {
-    /**
-     * :
-     */
     email?: pulumi.Input<inputs.AlertChannelEmail>;
     opsgenie?: pulumi.Input<inputs.AlertChannelOpsgenie>;
     pagerduty?: pulumi.Input<inputs.AlertChannelPagerduty>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `false`)
      */
     sendDegraded?: pulumi.Input<boolean>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `true`)
      */
     sendFailure?: pulumi.Input<boolean>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `true`)
      */
     sendRecovery?: pulumi.Input<boolean>;
     slack?: pulumi.Input<inputs.AlertChannelSlack>;
-    /**
-     * :
-     */
     sms?: pulumi.Input<inputs.AlertChannelSms>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `false`)
      */
     sslExpiry?: pulumi.Input<boolean>;
     /**
-     * . Possible values between 1 and 30. Default is `30`.
+     * Value must be between 1 and 30 (Default `30`)
      */
     sslExpiryThreshold?: pulumi.Input<number>;
     webhook?: pulumi.Input<inputs.AlertChannelWebhook>;
@@ -284,35 +207,29 @@ export interface AlertChannelState {
  * The set of arguments for constructing a AlertChannel resource.
  */
 export interface AlertChannelArgs {
-    /**
-     * :
-     */
     email?: pulumi.Input<inputs.AlertChannelEmail>;
     opsgenie?: pulumi.Input<inputs.AlertChannelOpsgenie>;
     pagerduty?: pulumi.Input<inputs.AlertChannelPagerduty>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `false`)
      */
     sendDegraded?: pulumi.Input<boolean>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `true`)
      */
     sendFailure?: pulumi.Input<boolean>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `true`)
      */
     sendRecovery?: pulumi.Input<boolean>;
     slack?: pulumi.Input<inputs.AlertChannelSlack>;
-    /**
-     * :
-     */
     sms?: pulumi.Input<inputs.AlertChannelSms>;
     /**
-     * . Possible values: `true` | `false`.
+     * (Default `false`)
      */
     sslExpiry?: pulumi.Input<boolean>;
     /**
-     * . Possible values between 1 and 30. Default is `30`.
+     * Value must be between 1 and 30 (Default `30`)
      */
     sslExpiryThreshold?: pulumi.Input<number>;
     webhook?: pulumi.Input<inputs.AlertChannelWebhook>;

package/bin/README.md

@@ -1,13 +1,12 @@
-**⚠️ This project is still in very early stages and breaking changes could happen**
-
 # Checkly Pulumi Provider
 
 The Checkly Pulumi provider enables you to create and configure Checkly resources using your favourite programming language.
+Note that this project is in its early stages and breaking changes could happen.
 
 ## Installation
 
-1. To use this package, please install the Pulumi CLI first.
-2. This package is only available for JavaScript and TypeScript but support for other languages/platforms, will be available soon.
+1. To use this package, please [install the Pulumi CLI first](https://www.pulumi.com/docs/get-started/install/).
+2. This package is only available for JavaScript and TypeScript but support for other languages will be available soon.
 
 ### Node.js (JavaScript/TypeScript)
 
@@ -23,14 +22,15 @@ or `yarn`:
 yarn add @checkly/pulumi
 ```
 
-### Python
-> TBA
+Install the provider binary plugin. This is only needed due to an outstanding bug in with Pulumi registry
 
-### Go
-> TBA
+```bash
+pulumi plugin install resource checkly v0.0.1-alpha.5 --server https://github.com/checkly/pulumi-checkly/releases/download/v0.0.1-alpha.5
+```
 
-### .NET
-> TBA
+### Python, Go & .NET
+
+*TBA*
 
 ## Authentication
 
@@ -56,28 +56,71 @@ Once you generated the `API Key` there are two ways to communicate your authoriz
 
 ## Creating Resources
 
+The example below shows a basic API check and Browser check.
+
 ```javascript
+// index.js
 const checkly = require("@checkly/pulumi")
 
 new checkly.Check("api-check", {
+  type: "API",
+  name: "Public SpaceX API",
   activated: true,
   frequency: 10,
-  type: "API",
+  locations: ["us-east-1"],
   request: {
     method: "GET",
     url: "https://api.spacexdata.com/v3",
+    assertions: [
+      {
+        source: 'STATUS_CODE',
+        comparison: 'EQUALS',
+        target: 200
+      },
+      {
+        source: 'JSON_BODY',
+        property: '$.project_name',
+        comparison: 'EQUALS',
+        target: 'SpaceX-API'
+      }
+    ]
   }
 })
 
 new checkly.Check("browser-check", {
+  type: "BROWSER",
+  name: "Google.com Playwright check",
   activated: true,
   frequency: 10,
-  type: "BROWSER",
-  script: `console`
+  locations: ["us-east-1"],
+  script: `const { chromium } = require('playwright')
+
+async function run () {
+  const browser = await chromium.launch()
+  const page = await browser.newPage()
+
+  const response = await page.goto('https://google.com')
+
+  if (response.status() > 399) {
+    throw new Error('Failed with response code ${response.status()}')
+  }
+
+  await page.screenshot({ path: 'screenshot.jpg' })
+
+  await page.close()
+  await browser.close()
+}
+
+run()`
 })
 ```
 
-> Check the `examples` directory for more detailed code samples.
+> Check the [examples directory](https://github.com/checkly/pulumi-checkly/tree/main/examples) for more detailed code samples.
+
+## Syncing resources
+
+Just run the regular `pulumi up` command
+
 
 ## Configuration
 
@@ -98,7 +141,7 @@ For detailed reference documentation, please visit [the Pulumi registry](https:/
 
 
 <p align="center">
-  <a href="https://checklyhq.com?utm_source=github&utm_medium=sponsor-logo-github&utm_campaign=headless-recorder" target="_blank">
+  <a href="https://checklyhq.com?utm_source=github&utm_medium=sponsor-logo-github&utm_campaign=pulumi-checkly" target="_blank">
   <img width="100px" src="https://www.checklyhq.com/images/text_racoon_logo.svg" alt="Checkly" />
   </a>
   <br />