Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Chore: Update README #528

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Chore: Update README #528

wants to merge 4 commits into from

Conversation

ytcleon
Copy link
Contributor

@ytcleon ytcleon commented Jan 15, 2025

Description

Currently some of the instructions in README use .env instead of Doppler and is not working. In addition it lacks some crucial details to connect to the production DB. This PR updates those instructions so others can properly set up a working local environment for the syndication API.

Add a more concrete example to change the SALESFORCE_* env var
in the config file
Current instruction is not working due to SSL verification error
ssl:true option is needed on the config file to bypass such error
in the DB connection string
@ytcleon ytcleon requested a review from a team as a code owner January 15, 2025 09:25
```yaml
DB:
host: "DATABASE_HOST_DOCKER" # DATABASE_HOST
```

### Running the API
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nitpick: I think we should stop mentioning the .env file on line 87 as we noticed that this needs to be on doppler instead.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I thought we still need to edit the .env for next-router. Just checked Doppler and all the syn- env var are available. Will update this part.

@@ -78,7 +87,12 @@ You MIGHT need:

If you need to use the database locally, set up the database by following the instructions in [next-syndication-db-schema](https://github.com/Financial-Times/next-syndication-db-schema).

If you are using postgres in Docker, you will need to edit your `.env` file to set `DATABASE_HOST` to `192.168.99.100`
If you are using postgres in Docker, you will need to edit your `custom-environment-variables.yaml` file to change `DATABASE_HOST` to `DATABASE_HOST_DOCKER` (variable already defined in Doppler).
Copy link
Contributor

@asugar13 asugar13 Jan 15, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thought: Thanks for adding these docs. I wonder if anyone ever ran postgres in Docker to run syndication 😅

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I doubt that too. In the README of next-syndication-db-schema it mentions setting up the Postgres DB in Docker (or tried to, since that section is empty 🤷), so I supposed someone might want to run the DB in Docker.

next-router uses Doppler to store its env var and all the syn- env var
are available in the dev environment in Doppler, so it is good to update those
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants