Gitea Repos - padogrid/padogrid GitHub Wiki

◀️ Private Bundle Repos :link: Running Bundles in Container ▶️

In addition to GitHub, PadoGrid supports private repos in Gitea. To connect to Gitea, you must set the following environment variables in the ~/.padogrid/setenv.sh file.

#
# Enter Gitea URL. Example: https://foo.com
#
GITEA_HTTPS_URL="https://foo.com"

#
# Enter Gitea ssh base URL. Example: [email protected]
#
GITEA_SSH_URL="[email protected]"

#
# Enter a space separated list of users of the alternate Gitea URL. In addition
# to the GitHub repos, these users' repos will be searched by the bundle commands.
#
GITEA_USERS="user1"

#
# Enter Gitea repo access token. For private repos, the repo access token is required.
#
GITEA_ACCESS_TOKEN="xxxxxxxxxxxxxx"
  • GITEA_HTTPS_URL is the URL that you would enter in the browser to access the Gitea repos.
  • GITEA_SSH_URL is the base ssh URL without the user name.
  • GITEA_USERS is a list of user names that you want the show_bundle to search for bundles.
  • GITEA_ACCESS_TOKEN is an access token provided by the Gitea user.

Creating Access Tokens

Access tokens are used to authenticate REST API calls made to Gitea. Access tokens can be created as follows.

  • From your Gitea site, select the Settings menu from the pull-down menu in the upper right corner.
  • Select the Applications tab.
  • Enter a token name in the Token Name field and select the Generate Token button.
  • Copy the token. Note that this token will not show again so you must paste it in a safe place.
  • Set GITEA_ACCESS_TOKEN to the token value. You can provide this token or a new token to other users who need access to your repos. You can create a new token for each user or use a token for a team or users.

Deploying ssh Keys to Gitea

PadoGrid currently supports only ssh connection to Gitea. You must deploy your ssh public key to Gitea as follows.

  • Copy the ~/.ssh/id_rsa.pub contents.
  • From your Gitea site, select the Settings menu from the pull-down menu in the upper right corner.
  • Select the SSH / GPG Keys tab.
  • Select the Add Kye button.
  • Enter a name for your key in the Key Name field.
  • Paste the key contents in the Content field.
  • Select the Add Key* button to save the key.

You can also allow other users to access your private repos by adding their public keys.

PadoGrid Bundle Commands

Once you have Gitea configured in PadoGrid as described above, you will be able to list bundles in the Gitea user's repos by running the show_bundle command and install bundles by running the install_bundle.

show_bundle Examples

To list all bundles with headers.

show_bundle -all -header

To show user1's combined catalog in the browser:

show_bundle -githost gitea -user user1 -catalog -all

❗ Note that you must always specify the -githost gitea -user user1 options when viewing Gitea catalogs.

install_bundle Examples

To install user1's bundle:

install_bundle -githost gitea -user user1 -download bundle-hazelcast-4-k8s-minishift

❗ Note that you must always specify the -githost gitea -user user1 options when installing Gitea bundles. There is one exception to this requirement, however. If the user name is padogrid then the -user option is not required.

# If the user name is 'padogrid' then you can run 'install_bundle' without the '-user' option:
install_bundle -githost gitea -download bundle-hazelcast-4-k8s-minishift

◀️ Private Bundle Repos :link: Running Bundles in Container ▶️