How to manage the Azion GitHub App

Azion GitHub App is a tool that connects your GitHub account with Azion’s platform. This application enables you to import your GitHub repositories and use them to build, deploy, and manage edge applications on the Azion Edge Platform.

This documentation explains how this application works and how to manage it according to your preferences.


Connecting Azion with your GitHub account

By using Azion Edge Platform, you can build, deploy, and manage edge applications based on an existing project imported from GitHub. For this, you must have an Azion account and a GitHub account.

Then, it’s necessary to connect your Azion account with GitHub through Azion Console. This way, you can grant permissions to Azion’s platform to import your existing repositories.

You can connect Azion with your GitHub account in two moments:

In both scenarios, you’ll be requested to confirm the installation of the Azion GitHub App and define your permissions and repository access as desired.

After you finish the installation of the Azion GitHub App, you can find it as part of your installed applications in the Settings of your GitHub account. Check the Managing the Azion GitHub App section for more details.


Permissions and features

Account permissions

Azion GitHub App can be installed on both organizations and personal GitHub accounts. The user needs to select the account to be connected to Azion’s platform when requested in the pop-up window that appears during the authorization process.

To install a GitHub App as an organization, you must be the organization owner or have admin permissions in a repository. Additionally, only owners can manage the settings of installed apps as an organization.

By installing the Azion GitHub App, the application can verify your GitHub identity and has read access to code, metadata, and resources you can access in your account.

Git Scopes

After the installation and authorization through Azion Console, the selected Git Scope will be visible on the screen to indicate the account that is being used to create a new edge application. To select a different Git Scope, click the dropdown menu and select a different one.

Repository permissions

It’s possible to give access to all repositories stored in your account or select specific repositories that the Azion GitHub App will have access to.

You can define this permission during the installation of the Azion GitHub App through Console. However, you can edit these settings at any time as explained in the Reviewing and editing Azion GitHub App configurations section.

Continuous deployment

After installing the Azion GitHub App, you’ll have a continuous deployment workflow when updating your edge application or repository. This way, every time you push code changes to your GitHub repository, those changes will be automatically deployed to your Azion’s edge environment, and vice versa, ensuring that your projects stay up-to-date.


Managing the Azion GitHub App

When you authorize and install the Azion GitHub App through Console, it appears as an installed application in your GitHub Account. To verify if the application was successfully connected and installed in your account, proceed as follows:

  1. Log in to your GitHub account.
  2. Go to the Account menu, located in the upper-right corner and identified with your avatar.
  3. Click the Settings option and a new page will open.
  4. On the left menu, select Applications in the Integrations section.
  5. A list of your GitHub Applications will be displayed.

The list of applications includes three tabs:

  • Installed GitHub Apps: all the installed GitHub Apps.
  • Authorized GitHub Apps: GitHub Apps with access to your account.
  • Authorized OAuth Apps: OAuth Apps with access to your account.

Read more about GitHub Apps in the official GitHub documentation.

Reviewing and editing Azion GitHub App configurations

On the Installed GitHub Apps list:

  1. Find the Azion GitHub App.
  2. Click the Configure button.
  • It’ll open a page with information related to the application.

You can read the description and Permissions granted, as well as review and edit the Repository access settings. At the bottom of the page, you’ll find the Danger zone section with options to suspend and uninstall the App.

Suspending Azion GitHub App access to the account resources

On the Installed GitHub Apps list:

  1. Find the Azion GitHub App.
  2. Click the Configure button.
  3. On the Danger zone section, click the Suspend button.
  • A modal will appear requesting to confirm the action.

Now the Azion GitHub App won’t have more access to your account resources.

Afterward, a Unsuspend button will be displayed. You can click on it to revert the suspension.

Uninstalling the Azion GitHub App

On the Installed GitHub Apps list:

  1. Find the Azion GitHub App.
  2. Click the Configure button.
  3. On the Danger zone section, click the Uninstall button.
  • A modal will appear requesting to confirm the action.

This removes the app and revokes access to all your account resources.

To reinstall the application, you need to complete the process as explained in the How to connect your Azion account with GitHub section.

Revoking Azion GitHub App access to the account

On the Authorized GitHub Apps list:

  1. Find the Azion GitHub App and click the Revoke button.
  • A modal will appear requesting to confirm the action and informing this action can’t be undone.

With this action, the Azion GitHub App will no longer be able to access the GitHub API.


Trademarks

GitHub is a trademark of GitHub, Inc.


Contributors