Set up a GitHub Codespace environment - Developer Guide - Cortex XSIAM - Cortex - Security Operations

Cortex XSIAM Developer Guide
Product
Cortex XSIAM
Creation date
2023-05-01
Last date published
2024-06-04
Category
Developer Guide

This topic provides step-by-step instructions for setting up a personal Codespace for developing Cortex XSIAM content.

What are GitHub Codespaces?

GitHub Codespaces are cloud-based development environments provided by GitHub that allow you to set up remote environments with preinstalled and preconfigured tools and dependencies using a dev container.

Your Codespace environment is hosted on GitHub's servers (attached to your GitHub account), and allows you to access your Codespace from any computer.

Cost and limitations

GitHub offers a free quota for Codespaces (which is higher for GitHub Pro users) that you can utilize for developing Cortex XSIAM content.

The quota is calculated based on the number of hours your Codespace is actively running. You can see the free quota plan and options for additional paid usage after you reach your quota, in the GitHub documentation.

You will receive an automated email notification when you have used 75%, 90%, and 100% of your free quota. You can find information about your Codespaces quota usage in the GitHub settings under Billing and plans. For more information, see the GitHub article Viewing your GitHub Codespaces usage.

Note

Codespaces generated from the content repository (or a fork of it) are configured to have four cores by default.

Create a new Codespace

  1. Log in to your GitHub account. If you do not have a GitHub account, you must create one before you can create a Codespace.

  2. Enter the content repository.

  3. Fork the repository to your account.

    1. Click Fork at the top right.

    2. Select your account as the owner, and leave the repository name as is.

    3. Keep the Copy the master branch only option selected.

    4. Create fork.

      content-new-fork-codespace.gif

  4. After a few seconds, you are redirected to your forked repository page.

  5. Create a new branch on your fork, and give it a meaningful name.

  6. Click Code, go to the Codespaces tab, and Create Codespace on \<branch name>.

    create-a-new-codespace.gif

    If the message This Codespace is requesting additional permissions appears, Continue without authorizing.

  7. Click New Codespace.

    This may take a few minutes to complete.

Configure an IDE