Skip to content

Commit 5f65d67

Browse files
djw-mdjw-m
authored
Merge pull request #6061 from EnterpriseDB/DOCS-916-add-artifactory-and-others-to-the-repos-integrat
Repos Update: Draft guides for integration
2 parents a7141d4 + db89a75 commit 5f65d67

File tree

2 files changed

+138
-4
lines changed

2 files changed

+138
-4
lines changed

‎advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx

Lines changed: 130 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,130 @@
1+
---
2+
title: Using Hosted Artifactory with EDB repositories
3+
navTitle: Hosted Artifactory
4+
description: How to use Hosted JFrog Artifactory with EDB repositories
5+
---
6+
7+
To set up Hosted JFrog Artifactory with EDB repositories, you need to create remote repositories in Artifactory. This article shows how to use Hosted JFrog Artifactory with EDB repositories. The process is different for on-premises Artifactory.
8+
9+
## Get the base URLs
10+
11+
The process is requires a base URLs to access the EDB repositories.
12+
13+
1. From your EDB account, [get your token](../../getting_started/with_cli/get_your_token).
14+
15+
1. Make a note of your token, for our examples, the token will be `xyz123`.
16+
17+
1. Select the repository you want to access, for example, `standard`. :
18+
19+
1. Your base URL will is then formed as:
20+
21+
```
22+
https://downloads.enterprisedb.com/<token>/<repository>/
23+
```
24+
25+
For the `standard` with our token, the repository, the base URL will be:
26+
27+
```
28+
https://downloads.enterprisedb.com/xyz123/standard/
29+
```
30+
31+
1. Append the appropriate path for the repository type.
32+
For example, for a Red Hat Enterprise Linux 9 on x86 architecture, append `rpm/el/9/x86_64/` and seperately append `rpm/el/9/noarch/` for the noarch packages, to create two base URLs. With our example, the base URLs will be:
33+
34+
```
35+
https://downloads.enterprisedb.com/xyz123/standard/rpm/el/9/x86_64/
36+
https://downloads.enterprisedb.com/xyz123/standard/rpm/el/9/noarch/
37+
```
38+
39+
## Setup Artifactory remote repositories
40+
41+
With your base URLs, you can now create the remote repositories in Artifactory.
42+
43+
Use the Artifactory UI to create the 2 repositories (`x86_64` and `noarch`), one for each base URL. The `x86_64` repository will contain the `rpm` packages specifically for the `x86_64` architecture, and the `noarch` repository will contain the `rpm` packages which are for any architecture.
44+
45+
Starting with the `x86_64` base URL:
46+
47+
1. Select **Create Repository** and choose **Remote**.
48+
1. Choose **rpm** as the repository type.
49+
1. Enter a unique name for the repository key, for example, `edb-x86_64`.
50+
1. Fill in the URL as `https://downloads.enterprisedb.com/xyz123/standard/rpm/el/9/x86_64/`.
51+
1. Select **Create Remote Repository**.
52+
53+
At this point, a prompt to setup the `yum` client configuration appears. This client configuration is the configuration you use on your local server or VM to access the configured EDB repositories via Artifactory.
54+
55+
6. On your local RHEL 9 server or VM create the yum repository file `/etc/yum.repos.d/artifactory-edb.repo`.
56+
57+
7. Add the text generated by Artifactory to the `/etc/yum.repos.d/artifactory-edb.repo` file. The generated text should resemble:
58+
59+
```
60+
[Artifactory]
61+
name=Artifactory
62+
baseurl=https://username%40domain:{artifactory_token}@username.jfrog.io/artifactory/edb-x86_64/<PATH_TO_REPODATA_FOLDER>
63+
enabled=1
64+
gpgcheck=0
65+
```
66+
67+
Remove the `<PATH_TO_REPODATA_FOLDER>` from the baseurl. It's not needed.
68+
69+
You should also edit the `Artifactory` name to be more descriptive and unique as there are multiple repositories to add. For example, append `-edb-x86_64` to the name to give:
70+
71+
```
72+
[Artifactory-edb-x86_64]
73+
name=Artifactory-edb-x86_64
74+
baseurl=https://username%40domain:{artifactory_token}@username.jfrog.io/artifactory/edb-x86_64/
75+
enabled=1
76+
gpgcheck=0
77+
```
78+
79+
Save the file.
80+
81+
8. Repeat the process, steps 1-7, to create an Artifactory remote repository for the `noarch` repository. When you generate the **yum** configuration text, add that text to the `/etc/yum.repos.d/artifactory-edb.repo` file previously created. The file should now contain:
82+
83+
```
84+
[Artifactory-edb-x86_64]
85+
name=Artifactory-edb-x86_64
86+
baseurl=username%40domain:{artifactry_token}@username.jfrog.io/artifactory/edb-x86_64/
87+
enabled=1
88+
gpgcheck=0
89+
90+
[Artifactory-edb-noarch]
91+
name=Artifactory-edb-noarch
92+
baseurl=username%40domain:{artifactry_token}@username.jfrog.io/artifactory/edb-noarch/
93+
enabled=1
94+
gpgcheck=0
95+
```
96+
97+
## Check the configuration works
98+
99+
On the local Linux server where the `/etc/yum.repos.d/artifactory-edb.repo` file resides, check that the repositories configuration is correct by running the following command:
100+
101+
102+
```bash
103+
dnf repolist | grep -i Art
104+
```
105+
106+
The output returned should be:
107+
108+
```
109+
Artifactory-edb-noarch Artifactory-edb-noarch
110+
Artifactory-edb-x86_64 Artifactory-edb-x86_64
111+
```
112+
113+
As you can see the two repositories are now configured.
114+
115+
You can now check for a specific package, such as `postgresextended` in the Artifactory repository, using the `dnf list` command. The package name for this example is `edb-postgresextended15-server` which is EDB Postgres Extended 15. To ensure that you don't get false positives from other repositories, disable all repositories using `--disable-repo=*` and then only enable the `Artifactory-` prefixed repositories using `--enablerepo=Artifactory-*`:
116+
117+
```bash
118+
dnf list edb-postgresextended15-server --disablerepo=* --enablerepo=Artifactory-*
119+
```
120+
121+
If configured and working correctly the output should resemble:
122+
123+
```
124+
Updating Subscription Management repositories.
125+
Last metadata expiration check: 0:01:58 ago on Thu 04 Jul 2024 06:00:31 EDT.
126+
Available Packages
127+
edb-postgresextended15-server.x86_64 15.7-2.el9 Artifactory-edb-x86_64
128+
```
129+
130+
The EDB package `edb-postgresextended15-server` is now available to install from the Artifactory repository.

‎advocacy_docs/repos/working_with_repos/integrating/index.mdx

Lines changed: 8 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,9 +4,13 @@ navTitle: Integrating
44
description: How to integrate EDB repositories with configuration management tools
55
---
66

7-
Content coming soon:
7+
In this section, you will find information on how to integrate EDB repositories with configuration management tools.
8+
9+
* [Hosted JFrog Artifactory](artifactory)
10+
11+
<br/>
12+
<br/>
13+
<br/>
14+
815

9-
* JFrog Artifactory
10-
* Satellite
11-
* Nexus
1216

0 commit comments

Comments
 (0)