From 793b1fc7f420ccd18ebf87cb9f3b57a759c6a115 Mon Sep 17 00:00:00 2001 From: Dj Walker-Morgan Date: Tue, 17 Sep 2024 14:05:56 +0100 Subject: [PATCH 1/9] First draft guide Signed-off-by: Dj Walker-Morgan --- .../integrating/artifactory.mdx | 130 ++++++++++++++++++ .../working_with_repos/integrating/index.mdx | 10 +- 2 files changed, 136 insertions(+), 4 deletions(-) create mode 100644 advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx diff --git a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx new file mode 100644 index 00000000000..d582a91082a --- /dev/null +++ b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx @@ -0,0 +1,130 @@ +--- +title: Using Artifactory with EDB repositories +navTitle: Artifactory +description: How to use JFrog Artifactory with EDB repositories +--- + +To set up JFrog Artifactory with EDB repositories, you need to create remote repositories in Artifactory. This article shows how to use JFrog Artifactory with EDB repositories. + +## Get the base URLs + +The process is requires a base URLs to access the EDB repositories. + +1. From your EDB account, [get your token](../../getting_started/with_cli/get_your_token). + +1. Make a note of your token, for our examples, the token will be `xyz123`: + +1. Select the repository you want to access, for example, `standard`. : + +1. Your base URL will is then formed as: + + ``` + https://downloads.enterprisedb.com///" + ``` + + For the `standard` with our token, the repository, the base URL will be: + + ``` + https://downloads.enterprisedb.com/xyz123/standard/ + ``` + +1. Append the appropriate path for the repository type. + 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: + + ``` + https://downloads.enterprisedb.com/xyz123/standard/rpm/el/9/x86_64/ + https://downloads.enterprisedb.com/xyz123/standard/rpm/el/9/noarch/ + ``` + +## Setup Artifactory remote repositories + +With your base URLs, you can now create the remote repositories in Artifactory. + +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. + +Starting with the `x86_64` base URL: + +1. Select **Create Repository** and choose **Remote**. +1. Choose **rpm** as the repository type. +1. Enter a unique name for the repository key, for example, `edb-x86_64`. +1. Fill in the URL as `https://downloads.enterprisedb.com/xyz123/standard/rpm/el/9/x86_64/`. +1. Select **Create Remote Repository**. + +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. + +6. On your local RHEL 9 server or VM create the yum repository file `/etc/yum.repos.d/artifactory-edb.repo`. + +7. Add the text generated by Artifactory to the `/etc/yum.repos.d/artifactory-edb.repo` file. The generated text should resemble: + + ``` + [Artifactory] + name=Artifactory + baseurl=https://username%40domain:{artifactory_token}@username.jfrog.io/artifactory/edb-x86_64/ + enabled=1 + gpgcheck=0 + ``` + + Remove the `` from the baseurl. It's not needed. + + You should also edit the `Atrifactory` 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: + + ``` + [Artifactory-edb-x86_64] + name=Artifactory-edb-x86_64 + baseurl=https://username%40domain:{artifactory_token}@username.jfrog.io/artifactory/edb-x86_64/ + enabled=1 + gpgcheck=0 + ``` + + Save the file. + +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: + + ``` + [Artifactory-edb-x86_64] + name=Artifactory-edb-x86_64 + baseurl=username%40domain:{artifactry_token}@username.jfrog.io/artifactory/edb-x86_64/ + enabled=1 + gpgcheck=0 + + [Artifactory-edb-noarch] + name=Artifactory-edb-noarch + baseurl=username%40domain:{artifactry_token}@username.jfrog.io/artifactory/edb-noarch/ + enabled=1 + gpgcheck=0 + ``` + +## Check the configuration works + +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: + + +```bash +dnf repolist | grep -i Art +``` + +The output returned should be: + +``` +Artifactory-edb-noarch Artifactory-edb-noarch +Artifactory-edb-x86_64 Artifactory-edb-x86_64 +``` + +As can be see our 2 repositories are now configured. + +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-*`: + +```bash +dnf list edb-postgresextended15-server --disablerepo=* --enablerepo=Artifactory-* +``` + +If configured and working correctly the output should resemble: + +``` +Updating Subscription Management repositories. +Last metadata expiration check: 0:01:58 ago on Thu 04 Jul 2024 06:00:31 EDT. +Available Packages +edb-postgresextended15-server.x86_64 15.7-2.el9 Artifactory-edb-x86_64 +``` + +The EDB package `edb-postgresextended15-server` is now available to install from the Artifactory repository. diff --git a/advocacy_docs/repos/working_with_repos/integrating/index.mdx b/advocacy_docs/repos/working_with_repos/integrating/index.mdx index 19048feb599..8b3feffc9f2 100644 --- a/advocacy_docs/repos/working_with_repos/integrating/index.mdx +++ b/advocacy_docs/repos/working_with_repos/integrating/index.mdx @@ -4,9 +4,11 @@ navTitle: Integrating description: How to integrate EDB repositories with configuration management tools --- -Content coming soon: +In this section, you will find information on how to integrate EDB repositories with configuration management tools. - * JFrog Artifactory - * Satellite - * Nexus + * [JFrog Artifactory](artifactory) + + + + From dec433f539b9eff6b65b1a9c9c585261fee6d474 Mon Sep 17 00:00:00 2001 From: Dj Walker-Morgan Date: Tue, 17 Sep 2024 14:07:52 +0100 Subject: [PATCH 2/9] clean up Signed-off-by: Dj Walker-Morgan --- .../repos/working_with_repos/integrating/artifactory.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx index d582a91082a..dc2c9ddded9 100644 --- a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx +++ b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx @@ -110,7 +110,7 @@ Artifactory-edb-noarch Artifactory-edb-noarch Artifactory-edb-x86_64 Artifactory-edb-x86_64 ``` -As can be see our 2 repositories are now configured. +As you can see the two repositories are now configured. 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-*`: From 6af4b91f506c2c9e0e8d934acaac65e446ef3b0a Mon Sep 17 00:00:00 2001 From: Dj Walker-Morgan <126472455+djw-m@users.noreply.github.com> Date: Mon, 14 Oct 2024 13:36:28 +0100 Subject: [PATCH 3/9] Update advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx --- .../repos/working_with_repos/integrating/artifactory.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx index dc2c9ddded9..59ac9e71768 100644 --- a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx +++ b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx @@ -19,7 +19,7 @@ The process is requires a base URLs to access the EDB repositories. 1. Your base URL will is then formed as: ``` - https://downloads.enterprisedb.com///" + https://downloads.enterprisedb.com/// ``` For the `standard` with our token, the repository, the base URL will be: From a811227e4c567a2c05733f240a4da993a68e9041 Mon Sep 17 00:00:00 2001 From: Dj Walker-Morgan <126472455+djw-m@users.noreply.github.com> Date: Mon, 14 Oct 2024 13:37:12 +0100 Subject: [PATCH 4/9] Update advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx --- .../repos/working_with_repos/integrating/artifactory.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx index 59ac9e71768..baae415d606 100644 --- a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx +++ b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx @@ -12,7 +12,7 @@ The process is requires a base URLs to access the EDB repositories. 1. From your EDB account, [get your token](../../getting_started/with_cli/get_your_token). -1. Make a note of your token, for our examples, the token will be `xyz123`: +1. Make a note of your token, for our examples, the token will be `xyz123`. 1. Select the repository you want to access, for example, `standard`. : From 134a25e637d87e63e0e3bf6effdf3c91b4285b9e Mon Sep 17 00:00:00 2001 From: Dj Walker-Morgan <126472455+djw-m@users.noreply.github.com> Date: Mon, 14 Oct 2024 13:38:02 +0100 Subject: [PATCH 5/9] Update advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx --- .../repos/working_with_repos/integrating/artifactory.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx index baae415d606..d96b5f39397 100644 --- a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx +++ b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx @@ -1,5 +1,5 @@ --- -title: Using Artifactory with EDB repositories +title: Using Hosted Artifactory with EDB repositories navTitle: Artifactory description: How to use JFrog Artifactory with EDB repositories --- From 3cfea0c0b4a6159b8777165bf4becc61e369aaba Mon Sep 17 00:00:00 2001 From: Dj Walker-Morgan <126472455+djw-m@users.noreply.github.com> Date: Mon, 14 Oct 2024 13:40:16 +0100 Subject: [PATCH 6/9] Make clear it is hosted artifactory --- .../repos/working_with_repos/integrating/artifactory.mdx | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx index d96b5f39397..31d4ac733dd 100644 --- a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx +++ b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx @@ -1,10 +1,10 @@ --- title: Using Hosted Artifactory with EDB repositories -navTitle: Artifactory -description: How to use JFrog Artifactory with EDB repositories +navTitle: Hosted Artifactory +description: How to use Hosted JFrog Artifactory with EDB repositories --- -To set up JFrog Artifactory with EDB repositories, you need to create remote repositories in Artifactory. This article shows how to use JFrog Artifactory with EDB repositories. +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. ## Get the base URLs From a2375e95a36ad1071a7faf24d1be3c44b23c89e2 Mon Sep 17 00:00:00 2001 From: Dj Walker-Morgan <126472455+djw-m@users.noreply.github.com> Date: Mon, 14 Oct 2024 13:43:28 +0100 Subject: [PATCH 7/9] Make space for an onprem-artifactory guide --- advocacy_docs/repos/working_with_repos/integrating/index.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/advocacy_docs/repos/working_with_repos/integrating/index.mdx b/advocacy_docs/repos/working_with_repos/integrating/index.mdx index 8b3feffc9f2..3ced2290d6c 100644 --- a/advocacy_docs/repos/working_with_repos/integrating/index.mdx +++ b/advocacy_docs/repos/working_with_repos/integrating/index.mdx @@ -6,8 +6,8 @@ description: How to integrate EDB repositories with configuration management too In this section, you will find information on how to integrate EDB repositories with configuration management tools. - * [JFrog Artifactory](artifactory) - + * [Hosted JFrog Artifactory](artifactory) + * [On premise JFrog Artifactory](onprem-artifactory) From e107a4936e1abbc8b61d64046730040fc9008658 Mon Sep 17 00:00:00 2001 From: Dj Walker-Morgan Date: Thu, 24 Oct 2024 16:03:11 +0100 Subject: [PATCH 8/9] Fix index page Signed-off-by: Dj Walker-Morgan --- .../repos/working_with_repos/integrating/index.mdx | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/advocacy_docs/repos/working_with_repos/integrating/index.mdx b/advocacy_docs/repos/working_with_repos/integrating/index.mdx index 3ced2290d6c..9e2c1f59ea5 100644 --- a/advocacy_docs/repos/working_with_repos/integrating/index.mdx +++ b/advocacy_docs/repos/working_with_repos/integrating/index.mdx @@ -7,8 +7,10 @@ description: How to integrate EDB repositories with configuration management too In this section, you will find information on how to integrate EDB repositories with configuration management tools. * [Hosted JFrog Artifactory](artifactory) - * [On premise JFrog Artifactory](onprem-artifactory) + +
+
+
- From db89a75c4dada5ba3f0b36a6b50b5bcbb0948e16 Mon Sep 17 00:00:00 2001 From: Dj Walker-Morgan <126472455+djw-m@users.noreply.github.com> Date: Thu, 24 Oct 2024 17:18:17 +0100 Subject: [PATCH 9/9] Correct type --- .../repos/working_with_repos/integrating/artifactory.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx index 31d4ac733dd..7cba2ee1ba1 100644 --- a/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx +++ b/advocacy_docs/repos/working_with_repos/integrating/artifactory.mdx @@ -66,7 +66,7 @@ At this point, a prompt to setup the `yum` client configuration appears. This cl Remove the `` from the baseurl. It's not needed. - You should also edit the `Atrifactory` 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: + 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: ``` [Artifactory-edb-x86_64]