/YugabyteDB-Fundamentals

Learn about the fundamental features of YugabyteDB, an open-source, distributed SQL database.

Primary LanguageJupyter Notebook

Fundamentals

YugabyteDB is the leading open source, distributed SQL database. The database has two APIs: YCQL and YSQL.

This repository is a lab resource in the free, YugabyteDB Fundamentals course from Yugabyte University.

YugabyteDB Fundamentals

Enroll for FREE at ... Yugabyte University.

To start the Gitpod environment, which is also free to use, select the link below. All you need is a Github account.

Gitpod is an on-demand developer environment for a GitHub, Git, or BitBucket workspace. It's super easy to use, offers 50 hours of free use per month, and only requires a chromium based browser.

Using Gitpod, you can run the notebook files in an on-demand VS Code, browser based environment. 😎

This repository contains the notebook files for Fundamentals, a free course that is soon-to-be available at university.yugabyte.com.

Using Gitpod, you can run the notebook files in an on-demand VS Code, browser based environment.

New to Github and Gitpod? Here's how to start...

  • First, create a Github account. It's free. https://github.com/join Then, in a browser, open the Gitpod link for the GitHub repository. It's a prefix - gitpod.io/# - and entire URL for the repository. For example, gitpod.io/#https://github.com/gitpod-io/website
  • Optionally, to make this a seamless one click installation, install the Gitpod browser extension. To learn more about the extension, see https://www.gitpod.io/docs/browser-extension
  • You will need to authorize Gitpod to use your GitHub account. Select Authorize gitpod.io.
  • Select your default editor, VS Code Browser. Select Continue.
  • Depending on the image configuration, it may take a few minutes for the image to build and to deploy to workspace.

FAQS

Will this repository or similar be made available at github.com/yugabyte?

  • Currently, no. Gitpod is not available for the Yugabyte account.

What is Gitpod?

  • Gitpod is a free developer service that makes it easy for maintainers to automate any non-executable setup instructions as code. Gitpod is part of Github.com. Gitpod launches pre-configured containers for a given project.

How much does Gitpod cost?

How can I sign up for Gitpod?

How do I start?

Why does it take 10 minutes to start up?

  • Gitpod builds a docker image for VS Code, related extensions, and YugabyteDB. This takes a few minutes. However, after your image is created, subsequent launches will be much faster.

OK, it started, BUT the ybu-lab terminal shows errors. What can I do???

  • There should be some helpful error messages, but in spite of that, you can run two scripts:
    • start_all.sh starts yugabyted and accepts 1 argument with zero or 1 value: zone, region, or cloud
    • stop_and_destroy_all.sh kills all the nodes.
  • Here's how to force the fix and get things back on track in the ybu-lab terminal:
      1. cd $GITPOD_REPO_ROOT
      1. .\stop_and_destroy_all.sh
      1. .\start_all.sh zone

I'm still running into issues. Where can I find help and support?

Release notes

Notes regarding updates to this repository.

  • 202430131
    • Update to 2.20.1
  • 20231219
    • Fixes to start and destroy scripts
  • 20231215
    • TPCC