GITBOOK-288: change request with no subject merged in GitBook
BIN
.gitbook/assets/image (1) (1) (1) (1).png
Normal file
|
After Width: | Height: | Size: 189 KiB |
|
Before Width: | Height: | Size: 189 KiB After Width: | Height: | Size: 195 KiB |
|
Before Width: | Height: | Size: 195 KiB After Width: | Height: | Size: 26 KiB |
|
Before Width: | Height: | Size: 26 KiB After Width: | Height: | Size: 5.6 KiB |
|
Before Width: | Height: | Size: 5.6 KiB After Width: | Height: | Size: 112 KiB |
@@ -4,8 +4,8 @@ In order to view recipe results and commit changes from a recipe back to GitLab,
|
||||
|
||||
To assist with that, this guide will:
|
||||
|
||||
* [Walk you through how to create a GitLab OAuth application](#step-1-create-an-oauth-application)
|
||||
* [Provide you with a list of necessary variables the agent needs to communicate with your GitLab instance](#step-2-configure-the-moderne-agent)
|
||||
* [Walk you through how to create a GitLab OAuth application](configure-an-agent-with-gitlab.md#step-1-create-an-oauth-application)
|
||||
* [Provide you with a list of necessary variables the agent needs to communicate with your GitLab instance](configure-an-agent-with-gitlab.md#step-2-configure-the-moderne-agent)
|
||||
|
||||
#### Prerequisites
|
||||
|
||||
@@ -17,29 +17,34 @@ To assist with that, this guide will:
|
||||
|
||||
1. Navigate to the Applications page for your organization: `https://gitlab.com/groups/<yourorg>/-/settings/applications`
|
||||
2. Provide an application name and redirect URI. The redirect URI will be in this format: `https://<tenantname>.moderne.io`:
|
||||
* <figure><img src="../../.gitbook/assets/Screenshot 2022-12-27 at 8.59.50 AM.png" alt=""><figcaption></figcaption></figure>
|
||||
*
|
||||
|
||||
<figure><img src="../../.gitbook/assets/Screenshot 2022-12-27 at 8.59.50 AM.png" alt=""><figcaption></figcaption></figure>
|
||||
3. Pick the following scopes:
|
||||
* <figure><img src="../../.gitbook/assets/Screenshot 2022-12-27 at 7.52.35 AM.png" alt=""><figcaption></figcaption></figure>
|
||||
*
|
||||
|
||||
<figure><img src="../../.gitbook/assets/Screenshot 2022-12-27 at 7.52.35 AM.png" alt=""><figcaption></figcaption></figure>
|
||||
4. Click the Save application button
|
||||
5. Copy the `Application ID` and `Secret` from this page; they will be used as arguments for the Moderne Agent:
|
||||
* <figure><img src="../../.gitbook/assets/Screenshot 2022-12-27 at 8.03.35 AM.png" alt=""><figcaption></figcaption></figure>
|
||||
*
|
||||
|
||||
<figure><img src="../../.gitbook/assets/Screenshot 2022-12-27 at 8.03.35 AM.png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
## Agent configuration
|
||||
|
||||
### Step 2: Configure the Moderne Agent
|
||||
|
||||
The following table contains all of the variables/arguments you need to add to your Moderne agent run command in order for it to work with your GitLab instance. Please note that these variables/arguments must be combined with ones found in other steps in the [Configuring the Moderne agent guide](/how-to/agent-configuration.md).
|
||||
The following table contains all of the variables/arguments you need to add to your Moderne agent run command in order for it to work with your GitLab instance. Please note that these variables/arguments must be combined with ones found in other steps in the [Configuring the Moderne agent guide](../agent-configuration.md).
|
||||
|
||||
You can configure multiple GitLab OAuth apps by including multiple entries, each with a different `{index}`.
|
||||
|
||||
{% tabs %}
|
||||
{% tab title="OCI Container" %}
|
||||
|
||||
**Variables:**
|
||||
|
||||
* `MODERNE_AGENT_GITLAB_{index}_OAUTH_CLIENTID` – _The application id configured in GitLab._
|
||||
* `MODERNE_AGENT_GITLAB_{index}_OAUTH_CLIENTSECRET` – _The secret configured in GitLab.`_
|
||||
* `MODERNE_AGENT_GITLAB_{index}_URL` – _The fully-qualified hostname of your GitLab instance.`_
|
||||
* `MODERNE_AGENT_GITLAB_{index}_OAUTH_CLIENTSECRET` – _The secret configured in GitLab.\`_
|
||||
* `MODERNE_AGENT_GITLAB_{index}_URL` – _The fully-qualified hostname of your GitLab instance.\`_
|
||||
* `MODERNE_AGENT_BITBUCKET_{index}_SKIPSSL` – _(Optional) Specifies whether or not to skip SSL validation for HTTP connections to this GitLab instance. This must be set to true if you use a self-signed SSL/TLS certificate. Defaults to `false`._
|
||||
|
||||
**Example:**
|
||||
@@ -55,12 +60,11 @@ docker run \
|
||||
{% endtab %}
|
||||
|
||||
{% tab title="Executable JAR" %}
|
||||
|
||||
**Arguments:**
|
||||
|
||||
* `--moderne.agent.gitlab[{index}].oauth.clientId` – _The application id configured in GitLab._
|
||||
* `--moderne.agent.gitlab[{index}].oauth.clientSecret` – _The secret configured in GitLab.`_
|
||||
* `--moderne.agent.gitlab[{index}].url` – _The fully-qualified hostname of your GitLab instance.`_
|
||||
* `--moderne.agent.gitlab[{index}].oauth.clientSecret` – _The secret configured in GitLab.\`_
|
||||
* `--moderne.agent.gitlab[{index}].url` – _The fully-qualified hostname of your GitLab instance.\`_
|
||||
* `--moderne.agent.gitlab[{index}].skipSsl` – _(Optional) Specifies whether or not to skip SSL validation for HTTP connections to this GitLab instance. This must be set to true if you use a self-signed SSL/TLS certificate. Defaults to `false`._
|
||||
|
||||
**Example:**
|
||||
@@ -74,4 +78,4 @@ java -jar moderne-agent-{version}.jar \
|
||||
# ... Additional arguments
|
||||
```
|
||||
{% endtab %}
|
||||
{% endtabs %}
|
||||
{% endtabs %}
|
||||
|
||||
@@ -1,36 +1,38 @@
|
||||
# Changelog
|
||||
|
||||
### UI v9.82.0 (2023/04/17)
|
||||
|
||||
- convert organizations and repository queries to paginated model
|
||||
We've complete a change to move over queries for _Organizations_ and _Repositories_ to use a new paginated query to improve the performance of filtering and selecting repositories. As apart of this change we've changed how _Repository groups_ are managed. Previously we had a transfer list that customers could use to handle selection. With this recent version, we've moved to a filterable data grid of repositories. 
|
||||
|
||||
<figure><img src="../.gitbook/assets/image.png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
### UI v9.81.1 (2023/04/14)
|
||||
|
||||
- Bug fixes and other improvements.
|
||||
* Bug fixes and other improvements.
|
||||
|
||||
### UI v9.81.0 (2023/04/14)
|
||||
|
||||
- Bug fixes and other improvements.
|
||||
* Bug fixes and other improvements.
|
||||
|
||||
### UI v9.80.3 (2023/04/12)
|
||||
|
||||
- Bug fixes and other improvements.
|
||||
* Bug fixes and other improvements.
|
||||
|
||||
### UI v9.80.2 (2023/04/10)
|
||||
|
||||
- Bug fixes and other improvements.
|
||||
* Bug fixes and other improvements.
|
||||
|
||||
### UI v9.80.1 (2023/04/01)
|
||||
|
||||
- Bug fixes and other improvements.
|
||||
* Bug fixes and other improvements.
|
||||
|
||||
### UI v9.80.0 (2023/03/31)
|
||||
|
||||
- add API examples for generating and downloading admin reports
|
||||
* add API examples for generating and downloading admin reports
|
||||
|
||||
### UI v9.79.0 (2023/03/31)
|
||||
|
||||
- add support for downloading `.tar.gz` and `.zip` version of the cli
|
||||
|
||||
* add support for downloading `.tar.gz` and `.zip` version of the cli
|
||||
|
||||
### UI v9.78.1 (2023/03/28)
|
||||
|
||||
@@ -93,7 +95,7 @@ _Language composition_ chart now contains more colors to help distinguish variou
|
||||
|
||||
Now you can download a Zip archive of Moderne CLI tools.
|
||||
|
||||
<img src="../.gitbook/assets/image (1).png" alt="" data-size="original">
|
||||
<img src="../.gitbook/assets/image (1) (1).png" alt="" data-size="original">
|
||||
|
||||
#### Organizations
|
||||
|
||||
@@ -108,7 +110,7 @@ Users will not be prompted for confirmation before removing repository.
|
||||
### UI v9.71.0 (2023/03/15)
|
||||
|
||||
* We have changed the name "Catalog" to "Marketplace" and given it a new icon. We hope the use of the word "Marketplace" reflects the community aspect of "Recipe" development.\
|
||||

|
||||
.png>)
|
||||
* Recipes can now have `maintainers` associated with them. This has been added to the graphQL API and the UI will render them in a special contributor's section on the recipe details page if present:\
|
||||
\
|
||||
.png>)
|
||||
@@ -466,7 +468,7 @@ ou may have noticed search markers displaying like this:\\
|
||||
|
||||
<figure><img src="../.gitbook/assets/image (2) (3) (1).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
<figure><img src="../.gitbook/assets/image (1) (1).png" alt=""><figcaption></figcaption></figure>
|
||||
<figure><img src="../.gitbook/assets/image (1) (1) (1).png" alt=""><figcaption></figcaption></figure>
|
||||
|
||||
In addition to search markers, we will render info/debug, warnings, and errors in a similar way:
|
||||
|
||||
|
||||