How to run integration tests using Github Actions

Chadwick — Fri, 19 Nov 2021 21:50:27 +0000

GitHub Actions allow us to easily verify if a Pull Request is safe to merge into a main branch.

This article assumes you have a basic functional understanding of Github and Integration Testing and will be covering:

How to run integration tests in a CI environment using GitHub Actions
How to prevent failing Pull Requests from being merged

🤖 Create the Workflow 🤖

In your Github repository, navigate to the Actions tab.

Chose the workflow template that best suits your needs, commit the changes, and pull the new .github/ folder into your local environment.

🔧 Customize the Workflow 🔧

Before making the following changes, create a new branch to edit your workflow to quickly iterate without jumping between editing and checking the workflow logs.

To add a test database, add a services section to the <project-root>/.github/workflow/workflow_name.yml file under the job name.

# .github/workflows/node.js.yml

...

jobs:
  # name of the job
  ci:

    # The OS of the docker container
    # Github runs the workflows on
    runs-on: ubuntu-latest

    strategy:
      matrix:
        # node version(s) to run against
        node-version: ['16.x']

    services:
      # name of the service
      postgresql:
        # The software image the container
        # will download and start
        image: 'postgres:14'
        ports:
          # map external port to container. This is
          # important because our app will run outside
          # our postgres container
          - '54320:5432'

        # Environment Variables
        env:
          POSTGRES_DB: example_app_test_db
          POSTGRES_PASSWORD: jamesbond
          POSTGRES_USER: example_app_db_test_user
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5

...

Update your code to point at the containerized database when running in the CI environment. The connection string will be consistent with the given environment variables and ports. e.g postgresql://example_app_db_test_user:jamesbond@localhost:54320/example_app_test_db

Update the steps section to set up and test your code.

# .github/workflows/node.js.yml
...
    steps:
    # Checkout our branch in the container
    - name: Checkout 🛎
      uses: actions/checkout@v2

    # Download and setup nodejs
    - name: Use Node.js ${{ matrix.node-version }}
      uses: actions/setup-node@v2
      with:
        node-version: ${{ matrix.node-version }}
        cache: 'npm'

    - name: Install dependencies 👨🏻‍💻
      run: npm ci

    - name: Migrate Database 🏗️
      run: npm run migrate

    - name: Seed Test Data 🌱
      run: npm run db:seed

    - name: run end-to-end tests 🧪
      run: npm run test
...

Go ahead and push those changes.

Inspect the logs by clicking the details link under the checks section near the merge button at the bottom of the page.

You can also see all workflow logs by navigating back to the actions tab.

Once your checks are coming back ✅, you're ready to merge that Pull Request and move on.

🥋 Respect the Workflow 🥋

If you want to protect your code from accidents or overconfidence, you can configure your repository to only allow merging Pull Requests that pass the checks.

Navigate to the repository branches settings and click the Add Rule button.

Configuration

Set Branch Name Pattern to * to match all branches (or whatever regex pattern you need to target certain branches)
Check Require status checks to pass before merging and search for the job name used in your .github/workflow/workflow_name.yml file. I used the name ci
Check Require branches to be up to date before merging

# .github/workflows/node.js.yml

...

jobs:
  # name of the job
  ci:
...

(Optional) Check Include Administrators to keep yourself from pushing breaking changes

🎉 Enjoy the Workflow 🎉

You've done it! Your code is now guarded by a robot.

Checkout my implementation and example pull requests in my end-2-end-integration-test-article-example.

Happy Coding!

DeFi Connected — Terra Hackathon

Luiz Lopes — Mon, 19 Apr 2021 22:42:28 +0000

DeFi isn’t rebuilding finance, it’s dismantling it. In its place, we build something so powerful it’ll change humanity’s fate. We are IDEO Colab Ventures, Delphi Labs and Terra. We want to join forces with YOU.

Join our 48h Terra Hackathon; lets build the next gen of DeFi together.

What you get as a participant

Access to Delphi Labs big brain support
IDEO product design tutorship
A chance to join our incubation program — with further access to funding and support from both Delphi Labs and IDEO Colab. Our team is working 24/7 helping to unlock the potential of DeFi.

IDEO Colab Ventures and Delphi Labs are investors & supporters of many disruptive teams, including:

We see the walls to mainstream adoption. And we want to incubate builders to break them down. That’s why we chose to join forces with Terra and Do Kwon.

They're solving many of the hardest problems in crypto:

On-ramps
Accessible UI
Developer on-boarding tools with Terra projects like Saturn, Alice, and Anchor.

So what actually will happen in the initial 48h event?

Delphi Labs and IDEO experts will lead your early-stage team through a design research sprint, as you talk to real end users and collaborate with peers, experts, and mentors in the DeFi community.
A small number of the most promising teams will be invited to the full 11-week residency. During this time each team will be assigned a senior member of Delphi Labs or IDEO as a mentor and have regular sessions with the wider team to share progress, get guidance and feedback.
At the end of the residency we expect that one or more of the projects will be offered full incubation. Allowing us to fund the projects from IDEO VC, Delphi Ventures and Delphi Labs while also providing deeper UI/visual design, token econ and hiring support.

What to get involved?

Submit your 1-minute application by Tuesday, April 27, 2021 at 00:00 (GMT+3).
We do not care where you are, or where you’ve been.We care about what you dream of building
Apply here: https://eventornado.com/event/defi-connected

Original Twitter 🧵: https://twitter.com/IDEOVC/status/1377377343421833220

Looking for ideas?

José Maria Macedo from Delphi Labs composed a wish-list of ideas that no one is yet building on Terra.

DEV Community: Delphi Digital